ttyverse

TTYverse provides powerful timeline navigation features, allowing you to browse different content streams, understand post formatting, and efficiently navigate through conversations.

Timeline Types

Home Timeline (Default)

Your personalized feed from accounts you follow:

/timeline               # Show home timeline (default)
/timeline home          # Explicit home timeline

Home timeline features:

Posts from accounts you follow
Your own posts
Boosts from people you follow
Replies in conversations you're part of
Chronological order (newest first)

Local Timeline

Posts from your instance/server community:

/timeline local         # Local instance posts
/timeline public        # Same as local

Local timeline shows:

Public posts from users on your instance
Community discussions
Local announcements
Instance-specific content

Federated Timeline

Posts from across the fediverse:

/timeline federated     # Federated timeline

Federated timeline includes:

Public posts from remote instances
Posts that have federated to your server
Broader fediverse conversations
Cross-instance discussions

Specialized Timelines

Notifications:

/timeline notifications # Your mentions, boosts, favorites, follows

Bookmarks:

/timeline bookmarks     # Posts you've bookmarked

Favorites:

/timeline favourites    # Posts you've favorited
/timeline favorites     # Same as favourites (both spellings work)

Post Display Format

Standard Post Format

TTYverse uses a consistent two-line format for all posts:

a0> {,POST_ID} <username> (2h ago) via TTYverse [Public]
    This is the post content with any links or hashtags

Metadata line breakdown:

a0> - Menu code for referencing this post
{,POST_ID} - Unique post identifier
- Who posted it (display name or @username)
(2h ago) - Relative timestamp
via TTYverse - Client application used
[Public] - Visibility level

Content line:

Post text content
Links and hashtags
Media descriptions

Visibility Indicators

Posts display their visibility level:

[Public] - Visible to everyone, appears in public timelines
[Unlisted] - Public but not in local/federated timelines
[Followers] - Only visible to followers
[Direct] - Direct message, only visible to mentioned users

Special Post Types

Content Warnings:

a1> {,POST_ID} <username> (1h ago) via Web [Public] [CW: Politics]
    [Content behind warning - politics discussion] Click to expand...

Polls:

a2> {,POST_ID} <username> (30m ago) via TTYverse [Public] [Poll]
    What's your favorite fediverse client?
    
    Poll:
    1. TTYverse (15 votes)
    2. Mastodon Web (8 votes)
    3. Tusky (5 votes)
    Total: 28 votes (single choice) - expires in 1 day, 12 hours
    Use /vote to participate

Boosted Posts:

a3> {,POST_ID} <booster> boosted <original_author> (15m ago) [Public]
    Original post content appears here with proper attribution

Engagement Stats:

a4> {,POST_ID} <username> (45m ago) via Web [Public] boosts: 12, favorites: 8
    Popular post content with engagement statistics shown

Timeline Movement

Basic navigation:

/again                  # Load more posts from current timeline
/refresh                # Refresh timeline for new posts
/last 20                # Show last 20 cached posts

Timeline switching:

/timeline               # Return to home timeline
/timeline local         # Switch to local timeline
/timeline federated     # Switch to federated timeline

Access cached content:

/last 10                # Show last 10 posts from cache
/last 50                # Show last 50 posts from cache

User-specific navigation:

/again @username        # View recent posts from specific user
/wagain @username       # View all recent activity from user

TTYverse assigns menu codes to posts for easy reference:

Code format:

First posts: a0, a1, a2, ... a9
Next set: b0, b1, b2, ... b9
Continues: c0, c1, etc.

Using menu codes:

/reply a3 Great point!   # Reply to post a3
/boost b7               # Boost post b7
/fav c2                 # Favorite post c2
/url a5                 # Open URL from post a5

Important: Menu codes change as new posts load, so use them promptly.

View conversation threads:

/thread a3              # Show full conversation thread for post a3

Thread display:

Shows conversation context
Maintains chronological order
Displays all participants
Uses mini-menu codes for interactions

Explore user content:

/whois @username        # Get user information
/again @username        # Show user's recent posts
/wagain @username       # Show all user activity

Content Filtering

Timeline-specific content:

Home timeline shows followed accounts only
Local timeline shows instance community
Federated timeline shows broader fediverse
Notifications show direct interactions

Timeline Management

Refresh Behavior

Automatic refresh:

Background process fetches new posts
Timeline updates without user intervention
Configurable refresh intervals

Manual refresh:

/refresh                # Force immediate refresh

Refresh intervals:

/set effpause 300       # Set refresh to 5 minutes (300 seconds)
/get effpause           # Check current refresh interval

Cache Management

Local caching:

Posts cached for /last command access
Reduces network requests
Faster access to recent content

Cache usage:

/last 15                # Access cached posts without network request

Timeline Interaction

Basic Interactions

All posts support standard interactions:

/reply a3 message       # Reply to post
/boost a3               # Boost/reblog post
/fav a3                 # Favorite post
/bookmark a3            # Bookmark for later
/url a3                 # Open URL from post

Poll Interactions

Voting in polls:

/vote a3 2              # Vote for option 2 (single choice)
/vote a3 1,3            # Vote for options 1 and 3 (multiple choice)
/vote a3 2-4            # Vote for range of options

User Interactions

From timeline posts:

/follow @username       # Follow user from their post
/whois @username        # Get user information
/again @username        # See more from this user

Timeline Customization

Display Options

Verbose mode:

/verbose                # Toggle detailed output

Shows additional information:

API request details
Post processing information
Network status updates

Debug mode:

/debug                  # Toggle debug information

Provides troubleshooting information:

API response details
Post parsing information
Error diagnostics

Color and Formatting

ANSI color support:

Visibility indicators in color
User highlighting
Engagement stats highlighting
Menu code formatting

Color configuration:

# In ~/.config/ttyverse/ttyverserc
ansi=1                  # Enable ANSI colors
noansi=0                # Disable colors for accessibility

Multi-Timeline Workflow

Morning routine:

/timeline               # Check home timeline
/timeline notifications # Check mentions and interactions
/timeline local         # See community activity
/dms                    # Check direct messages

Active engagement:

/timeline federated     # Discover new content
/search #topic          # Find specific discussions
/bookmark a3            # Save interesting content
/boost a5               # Share good content

Content creation:

/post message           # Share thoughts
/poll question          # Create community poll
/media /path/file       # Share media content

Timeline Combination Strategies

Discovery workflow:

Start with home timeline for familiar content
Check local timeline for community discussions
Browse federated timeline for new perspectives
Use search to find specific topics
Follow interesting users discovered

Engagement workflow:

Read and interact with home timeline posts
Participate in local community discussions
Share valuable content through boosts
Create original content and polls
Use bookmarks to save reference material

Performance Considerations

Network Efficiency

Optimized loading:

Background refresh reduces wait times
Cached posts available instantly with /last
Smart refresh intervals preserve bandwidth

Rate limit management:

Automatic rate limit detection
Efficient API usage
/rate command shows current limits

Memory Management

Long-running sessions:

Efficient post caching
Memory cleanup between refreshes
Background process optimization

Troubleshooting Timeline Issues

Common Problems

Timeline not loading:

Check network connectivity
Try /refresh to force reload
Verify authentication with /rate
Check server status

Old posts showing:

Use /refresh to get new content
Check if you're viewing cached posts (/last)
Ensure background refresh is working
Try switching timeline types

Menu codes not working:

Use current codes (they change with new posts)
Refresh timeline if codes are old
Check post still exists
Verify correct syntax

Missing posts:

Posts may not have federated yet
Check post visibility settings
Author may have deleted post
Try different timeline views

Debug Timeline Issues

Verbose output:

/verbose                # Enable detailed output
/refresh                # Refresh with verbose info

Check API status:

/rate                   # Check rate limits
/debug                  # Enable debug mode

See also: Basic Usage | Commands Reference | Advanced Features

Timeline Navigation