3
Basic Usage
Storm Dragon edited this page 2025-07-30 15:30:36 -04:00

Basic Usage

Essential workflows and everyday usage patterns for TTYverse. This guide assumes you've completed Getting Started and have TTYverse configured.

Daily Workflow

Starting TTYverse

# Start TTYverse
./ttyverse.pl

# TTYverse loads and shows:
# - Current version and login status
# - Recent timeline posts
# - Direct messages (if any)
# - Ready prompt: TTYverse>

Reading Your Timeline

When TTYverse starts, it automatically loads your home timeline:

a0> {,POST_ID} <username> (2h ago) via Web [Public]
    Content of the post goes here with any links or hashtags

a1> {,POST_ID} <username> (1h ago) via TTYverse [Unlisted]
    Another post with different visibility

Understanding the format:

  • a0, a1 - Menu codes for referencing posts
  • username - Who posted it
  • (2h ago) - How long ago it was posted
  • via Web - What client was used
  • [Public] - Visibility level

Loading More Content

# See more posts from timeline
/again

# Refresh timeline for new posts
/refresh

# See posts from cache
/last 15

Reading Different Timelines

Home Timeline (Default)

Your personalized feed from accounts you follow:

/timeline          # Show home timeline

Local Timeline

Posts from your instance/server:

/timeline local    # See what your community is posting

Federated Timeline

Posts from across the fediverse:

/timeline federated    # See the broader conversation

Bookmarks

Posts you've saved:

/timeline bookmarks    # Your saved posts

Interacting with Posts

Basic Interactions

# Like a post
/fav a3

# Share a post (boost/reblog)
/boost a3

# Save for later
/bookmark a3

# Reply to a post
/reply a3 Great point about accessibility!

When posts contain URLs:

# Open the URL from post a3
/url a3

# TTYverse automatically detects your environment:
# - GUI environment: Opens in Firefox, Chrome, etc.
# - Terminal: Opens in w3m, elinks, or lynx

Getting User Information

# Learn about a user
/whois storm@stormux.org

# Shows profile information, follower count, etc.

Creating Content

Simple Text Posts

# Create a public post
/post Just learned about TTYverse - loving the accessibility focus!

# TTYverse creates the post and shows confirmation

Posts with Media

# Upload an image
/media ~/pictures/sunset.jpg

# TTYverse will prompt for:
# 1. Alt-text description (required for images)
# 2. Optional post message

Alt-text example:

Enter alt text for sunset.jpg: Orange and purple clouds over mountains during golden hour
Enter post message (optional): Beautiful evening hike in the local mountains

Creating Polls

TTYverse supports both single and multiple choice polls:

Single choice poll (users pick one option):

/poll What's your favorite season?

Multiple choice poll (users can pick multiple options):

/mpoll Which TTYverse features do you use? (select all that apply)

Interactive poll creation process:

TTYverse> /poll What's your favorite programming language?
Creating single choice poll: What's your favorite programming language?
Poll duration (default 24h): 3d
Enter options (press Enter with no text to finish):
Option 1: Python
Option 2: JavaScript  
Option 3: Rust
Option 4: Go
Option 5: [press Enter to finish]
-- Poll posted successfully

Duration formats:

  • 24h = 24 hours
  • 3d = 3 days
  • 90m = 90 minutes
  • Empty = 24 hours (default)

Poll limitations:

  • Each option: maximum 50 characters
  • Minimum 2 options required
  • Most instances limit to 4 options

Replying to Conversations

# Reply to someone's post
/reply a5 That's exactly what I was thinking! Have you tried the new media upload feature?

# Your reply appears in the conversation thread

Managing Conversations

Direct Messages

# Check for direct messages
/dms

# Shows recent DMs:
[DM da0][friend@instance.org] (1h ago)
   Hey, saw your post about TTYverse - is it really that accessible?

# Reply to a DM
/reply da0 Yes! It's designed by a blind developer with accessibility as the top priority.

Following Conversations

# Follow an interesting user
/follow @username@instance.com

# Their posts will appear in your home timeline

Searching and Discovery

Finding Content

# Search for hashtags
/search #accessibility

# Find users
/search storm@stormux.org

# Search post content
/search "command line fediverse"

Exploring Communities

# See what your local instance is discussing
/timeline local

# Discover broader conversations
/timeline federated

# Find trending topics (if your server supports it)
/search #trending

Voting in Polls

When you see a poll in your timeline, it appears with numbered options:

b3> {,POST_ID} <username> (30m ago) via Web [Public]
    What's your favorite terminal editor?
    
    Poll (ends in 2 days, 15 votes):
    1. vim (8 votes - 53%)
    2. emacs (4 votes - 27%) 
    3. nano (3 votes - 20%)

Vote using the menu code and option number:

# Vote for option 1 (vim)
/vote b3 1

# For multiple choice polls, vote for multiple options
/vote b3 1,3

Managing Your Experience

Adjusting Settings

# Change how often timeline refreshes (in seconds)
/set effpause 300        # Refresh every 5 minutes

# Set your preferred browsers
/set gui_browser firefox
/set cli_browser w3m

# Check current settings
/get effpause

Getting Information

# See available commands
/help

# Check API rate limits
/rate

# See TTYverse version
/version

Controlling Output

# Enable detailed output
/verbose

# Enable debug information (for troubleshooting)
/debug

Sound Notifications

TTYverse includes audio feedback for different events:

  • New posts - Gentle notification sound
  • Mentions - Distinctive alert when someone mentions you
  • Direct messages - Special sound for private messages
  • Your posts - Confirmation when your posts appear
  • Boosts/favorites - Feedback when others interact with your posts

Sound files are stored in ~/.local/share/ttyverse/sounds/default/

Common Workflows

Morning Routine

# Start TTYverse and catch up
./ttyverse.pl           # Shows recent timeline
/dms                    # Check direct messages
/timeline local         # See community activity

Active Participation

# Engage with interesting content
/fav a3                 # Like interesting posts
/boost a5               # Share good content
/reply a7 Great insight! # Join conversations
/post Today I learned... # Share your thoughts

Content Creation

# Share a photo with proper accessibility
/media ~/photo.jpg
# Alt-text: "Golden retriever playing in autumn leaves"
# Message: "Morning walk with the dog - beautiful fall colors!"

Research and Discovery

# Explore topics
/search #photography    # Find photography discussions
/timeline federated     # See broader conversations
/search @expert         # Find knowledgeable users
/follow @expert@domain  # Follow interesting people

End of Session

# Save interesting posts for later
/bookmark a3
/bookmark b7

# Exit cleanly
/quit

Tips for Effective Usage

Navigation Tips

  1. Use menu codes efficiently - They're faster than scrolling
  2. Bookmark interesting posts - Save them for later reference
  3. Follow local timeline - Discover your community
  4. Use search regularly - Find conversations on topics you care about

Engagement Tips

  1. Always provide alt-text - TTYverse enforces this for good reason
  2. Reply thoughtfully - Add value to conversations
  3. Use appropriate visibility - Consider who should see your posts
  4. Boost good content - Help spread valuable information

Accessibility Tips

  1. TTYverse is screen reader friendly - All output is plain text
  2. Sound notifications help - Audio cues for different events
  3. Consistent structure - Posts always follow the same format
  4. Keyboard-only navigation - No mouse required anywhere

Performance Tips

  1. Adjust refresh rate - Slower connections benefit from longer intervals
  2. Use /last command - Access cached posts without network requests
  3. Bookmark instead of searching - Faster access to interesting content

Troubleshooting Common Issues

Timeline Issues

# Timeline won't load
/refresh                # Force refresh
# Check network: ping 8.8.8.8

# Old posts showing
/timeline               # Reload home timeline

Interaction Problems

# Menu codes not working
# Make sure you're using current codes (they change as new posts load)

# Can't reply or boost
# Check if post is still available: /url a3

Media Upload Issues

# Image upload fails
# Ensure file exists: ls -la ~/path/to/image.jpg
# Check file size (8MB limit for images on most servers)
# Provide meaningful alt-text (required!)

See also: Getting Started | Commands Reference | Media Uploads