Table of Contents
- Commands Reference
- Timeline & Navigation Commands
- Posting Commands
- /post <message>
- /reply <code> <message>
- /media <filepath> [message]
- /poll <question>
- /mpoll <question>
- Interaction Commands
- /boost <code>
- /unboost <code>
- /fav <code> / /favorite <code>
- /unfav <code>
- /bookmark <code>
- /unbookmark <code>
- /vote <code> <choices>
- Direct Messages
- Search Commands
- Account & Profile Commands
- /follow <username>
- /unfollow <username>
- /followers [username] [+count]
- /following [username] [+count]
- /syncprofile
- /profileup
- /profiledown
- /block <username>
- /unblock <username>
- /mute <username>
- /unmute <username>
- URL & Link Commands
- Information Commands
- Configuration Commands
- System Commands
- Debug Commands
- Menu Codes
- Visibility Levels
- Command Aliases
- Tips
- Error Handling
Commands Reference
Complete reference for all TTYverse commands. Commands are entered at the TTYverse>
prompt and always start with /
.
Timeline & Navigation Commands
/timeline [type]
Display timeline content.
Usage:
/timeline
- Show home timeline (default)/timeline local
- Show local instance timeline/timeline federated
- Show federated timeline/timeline bookmarks
- Show bookmarked posts
Examples:
/timeline # Home timeline
/timeline local # Local posts
/timeline federated # All federated posts
/timeline bookmarks # Your bookmarks
/again
Show more posts from the current timeline.
/refresh
Refresh the current timeline and fetch new posts.
/last [number]
Show the last N posts from cache.
Example:
/last 10 # Show last 10 posts
Posting Commands
/post <message>
Create a new public post.
Usage:
/post Hello fediverse!
/post This is a longer post with multiple words
Note: Posts default to public visibility.
/reply <code> <message>
Reply to a specific post using its menu code.
Usage:
/reply a3 Thanks for sharing!
/reply b1 Great point about accessibility
/media <filepath> [message]
Upload media (image, audio, video) with optional post text.
Usage:
/media /path/to/image.jpg # Upload image only
/media /path/to/audio.mp3
Accessibility: Images require alt-text descriptions. TTYverse will prompt for alt-text and cancel uploads without descriptions.
Supported formats:
- Images: JPEG, PNG, GIF, WebP
- Audio: MP3, OGG, WAV, FLAC, M4A
- Video: MP4, WebM, MOV
/poll <question>
Create a single choice poll where users can select one option.
Usage:
/poll What's your favorite programming language?
Interactive process:
- Enter poll question after
/poll
- Set poll duration (default 24h):
3d
,12h
,90m
, or press Enter - Enter options one by one (up to 10, though most instances limit to 4)
- Press Enter on empty line to finish and post
Duration formats:
24h
- 24 hours3d
- 3 days90m
- 90 minutes- Default: 24 hours if left empty
Limitations:
- Each option limited to 50 characters
- Minimum 2 options required
- Most instances limit to 4 options (TTYverse allows up to 10)
/mpoll <question>
Create a multiple choice poll where users can select multiple options.
Usage:
/mpoll Which features do you use most? (select all that apply)
Process: Same as /poll
but creates a multiple choice poll where voters can select multiple options.
Example workflow:
TTYverse> /poll Choose your favorite color
Creating single choice poll: Choose your favorite color
Poll duration (default 24h): 2d
Enter options (press Enter with no text to finish):
Option 1: Red
Option 2: Blue
Option 3: Green
Option 4: [press Enter]
-- Poll posted successfully (ID: 01K1BWFGCB...)
Interaction Commands
/boost <code>
Boost (reblog) a post.
Usage:
/boost a3 # Boost post a3
/boost b7 # Boost post b7
/unboost <code>
Remove boost from a post.
/fav <code>
/ /favorite <code>
Favorite (like) a post.
Usage:
/fav a3 # Favorite post a3
/favorite b1 # Same as /fav
/unfav <code>
Remove favorite from a post.
/bookmark <code>
Bookmark a post for later.
/unbookmark <code>
Remove bookmark from a post.
/vote <code> <choices>
Vote in a poll.
Usage:
/vote a3 1 # Vote for option 1 (single choice poll)
/vote b2 2,3 # Vote for options 2 and 3 (multiple choice poll)
/vote c1 1-3 # Vote for options 1 through 3 (multiple choice poll)
Notes:
- Single choice polls: Only one option can be selected
- Multiple choice polls: Multiple options can be selected using commas or ranges
- Poll identification: Polls are marked with
[Poll]
in the post display - Vote status: Shows "(multiple choice)" for multiple choice polls
Direct Messages
/dms
Show recent direct messages.
/reply <dm_code> <message>
Reply to a direct message.
Usage:
/reply da1 Thanks for the message!
Search Commands
/search <query>
Search for posts, hashtags, or accounts.
Usage:
/search #accessibility # Search hashtag
/search @username@instance.com # Search user
/search "climate change" # Search text
/search technology # Search term
/whois <username>
Get information about a user.
Usage:
/whois storm@stormux.org
/whois @localuser
Account & Profile Commands
/follow <username>
Follow a user.
Usage:
/follow @stormux@social.stormux.org
/follow @localuser
/unfollow <username>
Unfollow a user.
/followers [username] [+count]
Show followers for yourself or specified user.
Usage:
/followers # Show your followers
/followers @user@instance.com # Show user's followers
/followers +50 # Show up to 50 of your followers
/followers @user +20 # Show up to 20 of user's followers
Aliases: /fos
(short for "followers")
Notes:
- Default shows up to 20 followers
- Maximum 80 followers per request (Mastodon API limit)
- Shows account display name, username, and follower/following counts
/following [username] [+count]
Show who you or specified user follows.
Usage:
/following # Show who you follow
/following @user@instance.com # Show who user follows
/following +50 # Show up to 50 accounts you follow
/following @user +20 # Show up to 20 accounts user follows
Aliases: /friends
, /frs
(short for "friends")
Notes:
- Default shows up to 20 following accounts
- Maximum 80 accounts per request (Mastodon API limit)
- Shows account display name, username, and follower/following counts
/syncprofile
Sync your profile changes from local .profile
file to server.
Usage:
/syncprofile # Smart bidirectional sync
Notes:
- Compares local
.profile
file with server profile - Only uploads changed fields
- Creates
.profile
template if it doesn't exist - Safe default:
use_profile = false
until you enable it
/profileup
Force upload local profile to server (local → server).
Usage:
/profileup # Force upload all local profile data
Notes:
- Uploads all profile fields from local
.profile
file - Overwrites server profile with local data
- Use with caution - doesn't compare with server first
/profiledown
Force download server profile to local file (server → local).
Usage:
/profiledown # Download server profile to local file
Notes:
- Overwrites local
.profile
file with server data - Preserves
use_profile
setting - Useful for syncing server changes back to local file
/block <username>
Block a user.
/unblock <username>
Unblock a user.
/mute <username>
Mute a user.
/unmute <username>
Unmute a user.
URL & Link Commands
/url <code>
Open URL from a post in your browser.
Usage:
/url a3 # Open URL from post a3
TTYverse automatically detects your environment and uses:
- GUI browsers: Firefox, Chrome, etc. (if DISPLAY is set)
- CLI browsers: w3m, elinks, lynx (in terminal)
Configuration:
- Set
gui_browser
in config for GUI preference - Set
cli_browser
in config for CLI preference
Information Commands
/help
Show available commands.
/version
Show TTYverse version information.
/about
Show information about TTYverse.
/rate
Show current API rate limit status.
Configuration Commands
/set <option> <value>
Change configuration options.
Common options:
/set effpause 60 # Set refresh interval (seconds)
/set gui_browser firefox # Set GUI browser
/set cli_browser w3m # Set CLI browser
/get <option>
Show current value of configuration option.
System Commands
/quit
/ /exit
Exit TTYverse.
/restart
Restart TTYverse (reload configuration).
Debug Commands
/verbose
Toggle verbose output for debugging.
/debug
Toggle debug output for troubleshooting.
Menu Codes
TTYverse assigns menu codes to posts for easy reference:
- Posts:
a0
,a1
,a2
, ...a9
,b0
,b1
, etc. - DMs:
da0
,da1
,da2
, etc.
Codes are assigned in chronological order, with newer posts getting later codes.
Visibility Levels
When posting, content visibility is shown:
- [Public] - Visible to everyone, appears in timelines
- [Unlisted] - Public but not in local/federated timelines
- [Followers] - Only followers can see
- [Direct] - Only mentioned users can see
Command Aliases
Some commands have shorter aliases:
/fav
=/favorite
/boost
=/reblog
/dms
=/dm
/quit
=/exit
=/q
/poll
= single choice poll/mpoll
= multiple choice poll
Tips
- Tab completion: Most commands support tab completion
- Command history: Use up/down arrows for command history
- Multiple words: Wrap multi-word arguments in quotes if needed
- Case sensitivity: Commands are case-insensitive
- Menu codes: Always use current menu codes (they change as new posts load)
Error Handling
Common error messages:
- "Invalid menu code" - Post code doesn't exist or is old
- "Rate limit exceeded" - API calls too frequent, wait a moment
- "Not found" - User or post doesn't exist
- "Unauthorized" - Authentication problem, check OAuth setup
See also: Getting Started | Basic Usage | Advanced Features