storm/ttyverse
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Page: Commands Reference
Pages
Advanced Features Basic Usage Commands Reference Configuration Direct Messages Extension Development Extensions FAQ Getting Started Home Installation Media Uploads Polls Posting Quick Commands Search Timeline Navigation Troubleshooting
Clone
7
Commands Reference
Storm Dragon edited this page 2025-08-11 03:20:39 -04:00
Table of Contents

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:

  1. Enter poll question after /poll
  2. Set poll duration (default 24h): 3d, 12h, 90m, or press Enter
  3. Enter options one by one (up to 10, though most instances limit to 4)
  4. Press Enter on empty line to finish and post

Duration formats:

  • 24h - 24 hours
  • 3d - 3 days
  • 90m - 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.

Usage:

/bookmark a3     # Bookmark post a3
/bookmark b7     # Bookmark post b7

/unbookmark <code>

Remove bookmark from a post.

Usage:

/unbookmark a3   # Remove bookmark from post a3
/unbookmark b7   # Remove bookmark from post b7

/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 <code>

Block a user by username or menu code.

Usage:

/block @spammer@bad.example    # Block by username
/block spammer@bad.example     # Block by username (@ optional)
/block d4                      # Block author of post d4

Notes:

  • Requires confirmation for blocking
  • Menu codes target the author of the specified post
  • Blocked users cannot interact with your posts or see your content

/unblock <username> / /unblock <code>

Unblock a previously blocked user.

Usage:

/unblock @user@example.com     # Unblock by username
/unblock d4                    # Unblock author of post d4

Notes:

  • No confirmation required for unblocking
  • Restores normal interaction with the user

/mute <username> / /mute <code>

Mute a user by username or menu code.

Usage:

/mute @noisy@loud.example      # Mute by username  
/mute noisy@loud.example       # Mute by username (@ optional)
/mute d4                       # Mute author of post d4

Notes:

  • Requires confirmation for muting
  • Automatically includes notifications=true (mutes notifications too)
  • Menu codes target the author of the specified post
  • Muted users' posts won't appear in your timeline
  • Muted users' notifications are also blocked

/unmute <username> / /unmute <code>

Unmute a previously muted user.

Usage:

/unmute @user@example.com      # Unmute by username
/unmute d4                     # Unmute author of post d4

Notes:

  • No confirmation required for unmuting
  • Restores posts and notifications from the 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

Menu Code Support

These commands support both usernames and menu codes:

  • /block - Block user by username or post code
  • /unblock - Unblock user by username or post code
  • /mute - Mute user by username or post code
  • /unmute - Unmute user by username or post code

Tips

  1. Tab completion: Most commands support tab completion
  2. Command history: Use up/down arrows for command history
  3. Multiple words: Wrap multi-word arguments in quotes if needed
  4. Case sensitivity: Commands are case-insensitive
  5. 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