TTYverse Wiki
TTYverse is a command-line fediverse client for Mastodon, GoToSocial, and other ActivityPub servers. Originally forked from TTYtter, it's been completely rebuilt for the fediverse era with accessibility and usability as core principles.
Quick Start
New to TTYverse? → Getting Started | Installation
Need help with a command? → Commands Reference | Quick Command List
Having issues? → Troubleshooting | FAQ
Navigation
📚 User Guides
- Getting Started - First-time setup and basic usage
- Installation - Download, install, and initial configuration
- Basic Usage - Essential commands and workflows
- Advanced Features - Power user features and customization
📖 Reference Documentation
- Commands Reference - Complete command documentation
- Configuration - Settings, options, and customization
- Keyboard Shortcuts - Terminal navigation and hotkeys
- File Locations - Config files, logs, and data storage
🔧 Technical Documentation
- Extensions - Sound packs, TTS, and custom extensions
- OAuth Setup - Server authentication and key management
- API Integration - Mastodon API usage and limitations
- Architecture - Multi-process design and IPC
🆘 Support & Troubleshooting
- Troubleshooting - Common issues and solutions
- FAQ - Frequently asked questions
- Error Messages - What error messages mean and how to fix them
- Performance - Optimizing TTYverse for your system
🎯 Feature Guides
- Timeline Navigation - Reading posts, filtering, and browsing
- Posting - Creating posts, replies, and using visibility settings
- Media Uploads - Images, audio, video, and accessibility
- Direct Messages - Private messaging and conversations
- Polls - Creating and voting on polls
- Search - Finding posts, people, and hashtags
🌐 Fediverse Integration
- Server Compatibility - Mastodon, GoToSocial, Pleroma support
- Instance Features - Feature differences across servers
- Cross-Instance - Following and interacting across servers
🔨 Development
- Contributing - How to contribute to TTYverse
- Development Setup - Setting up a development environment
- Extension Development - Creating custom extensions
- Testing - Running tests and validation
Quick Reference
Essential Commands
/help
- Show available commands/timeline
- Show timeline (home, local, federated, bookmarks)/post message
- Create a new post/reply a3 message
- Reply to post a3/boost a3
- Boost post a3/fav a3
- Favorite post a3/dms
- Show direct messages/media /path/file
- Upload media with post/search term
- Search posts and accounts/quit
- Exit TTYverse
Key Features
- 🎵 Sound Notifications - Audio feedback for different post types
- ♿ Accessibility First - Alt-text enforcement and screen reader friendly
- 🔐 OAuth 2.0 - Secure authentication with any fediverse server
- ⚡ Real-time Updates - Background monitoring and notifications
- 🎨 Extensions - Sound packs, TTS, notifications, and more
- 📱 Multi-format - Text, images, audio, video, and polls
About TTYverse
License: Floodgap Free Software License
Original: Forked from TTYtter by Cameron Kaiser
Maintainer: Storm Dragon
Repository: https://git.stormux.org/storm/ttyverse
Philosophy
"If you're going to use a client maintained by a blind guy, you can damn well describe your images!"
TTYverse prioritizes accessibility, usability, and the principles of the open fediverse. Every feature is designed with screen reader users and keyboard navigation in mind, while remaining powerful for all users.
Getting Help
- Commands: Type
/help
in TTYverse for command list - Issues: Report bugs at https://git.stormux.org/storm/ttyverse/issues
- Wiki: This wiki for comprehensive documentation
- Community: Find support in the fediverse community