Skip to content

OshiSocial How-to Guides

OshiSocial

OshiSocial How-to Guides

Complete tutorials and guides for mastering OshiSocial features


Fediverse Culture & Tips

✅ Do’s - Best Practices

Use Emoji to Enhance Your Posts

Consider using emoji to spice up your posts! They help beautify text posts and make them more engaging for your audience. Emoji can convey tone, add personality, and make your content stand out in timelines.

Use Hashtags Wisely

Hashtags are essential for new users because posts without hashtags are mostly only visible to your followers and local instance. Many Mastodon and fediverse users discover content by following hashtags like topics, making them crucial for expanding your reach.

Best practices:

  • Use relevant hashtags that match your content
  • Include 2-5 hashtags per post for optimal discovery
  • Check trending hashtags for current conversations
  • Create descriptive hashtags for niche topics
  • Hashtags can be placed in the body or after posts

❌ Don’ts - Common Mistakes to Avoid

Don't Abuse Hashtags

This isn’t Instagram! Excessive or irrelevant hashtag use is considered spam and desperate behavior in the fediverse. Using unrelated hashtags just to gain visibility will very likely get you blocked and/or reported.

What to avoid:

  • Stuffing posts with 10+ hashtags
  • Using popular but unrelated hashtags
  • Adding hashtags that don’t match your content
  • Hashtag spam in replies or comments
Avoid Double Posting with Hashtags

While having backup accounts is understandable, posting identical content across multiple accounts creates duplicates in topic feeds. When users follow a hashtag, they’ll see the same content multiple times, which is frustrating.

Consequences:

  • You’ll very likely be blocked and/or reported for spam
  • Damages your reputation across instances
  • Reduces engagement on all your accounts

Better approach:

  • Share different aspects or perspectives on each account
  • Use boosts/reblogs to cross-promote
  • Download backups instead of creating duplicate accounts for archival
  • Ensure unique content across different accounts when posting similar topics

❕ Important Considerations

Adding alt-text may be extra work, but it’s a crucial accessibility feature that:

  • Helps screen reader users understand image content
  • Provides context when images fail to load
  • Improves searchability of your posts
  • Shows respect for all community members

Additional Cultural Guidelines

Use content warnings (CW) for:

  • Political discussions
  • Mental health topics
  • Food posts (for those with eating disorders)
  • Eye contact in photos
  • Animated GIFs (for those with epilepsy)
  • Spoilers for media
  • NSFW content

ListenBrainz Integration

Connect Your Account

Navigate to Settings → Integrations and locate the ListenBrainz section. Enter your ListenBrainz username to begin the connection process.

Authorize Access

Click “Authorize” to grant OshiSocial permission to display your listening history. You’ll be redirected to ListenBrainz for authentication.

Configure Display

Choose how your “Now Playing” music tile appears on your profile. You can customize the visibility and update frequency.


Acceptable Advertising:

  • Creative projects and personal work
  • Community events and gatherings
  • Non-profit initiatives
  • Collaborative opportunities

Not Permitted:

  • Spam or repetitive commercial posts
  • MLM or pyramid schemes
  • Misleading or deceptive content
  • Excessive self-promotion

Discover Content & Follow Topics

Explore Hashtags

Use hashtags to discover content about specific topics. Popular hashtags appear in the trending section.

Follow Topics

Save hashtags and create custom feeds to stay updated on topics you care about.

Federated Timeline

View the federated timeline to discover content from connected instances.

Local Timeline

Focus on your home instance’s community by viewing the local timeline.


Profile & Name Customization

Your display name can include:

  • Emoji and special characters
  • Up to 30 characters
  • Unicode support for multiple languages

To change: Settings → Profile → Display Name


Theme Customization

OshiSocial leverages Misskey/Sharkey’s powerful customization capabilities:

Built-in Themes

Choose from pre-installed themes:

  • Light and Dark modes
  • High contrast options
  • Seasonal themes
  • Community-created themes
UI Layout

Customize your dashboard layout:

  • Rearrange widgets
  • Resize columns
  • Hide/show interface elements
  • Create multiple workspace layouts

Preferences Backup

Export Settings

Go to Settings → Data Export → Export Preferences. This creates a JSON file with all your customizations.

Save Backup

Store the exported file in a safe location. Consider using cloud storage or version control.

Restore Settings

To restore: Settings → Data Import → Import Preferences. Upload your backup file to restore all settings.


Push Notifications

Enable Notifications:

  1. Click the notification bell icon in the top bar
  2. Select “Enable Push Notifications”
  3. Grant browser permission when prompted
  4. Customize which events trigger notifications

Disable Notifications:

  1. Access Settings → Notifications
  2. Toggle off “Push Notifications”
  3. Optionally revoke browser permissions

Reporting Content

OshiSocial strives to provide best-effort moderation reactively. Here’s how to report issues:

Report Types:

  • Spam: Unsolicited commercial content or repetitive posts
  • Harassment: Targeted attacks or unwanted contact
  • Inappropriate Content: Violations of community standards
  • Impersonation: Accounts pretending to be someone else

How to Report:

  1. Click the three-dot menu on any post or profile
  2. Select “Report”
  3. Choose the appropriate category
  4. Provide detailed context
  5. Submit for moderator review

Mute & Block Features

User Muting:

  • Hides posts from specific users
  • They won’t know they’re muted
  • Can still see their profile if visited directly

Word Muting:

  • Filter posts containing specific terms
  • Supports regular expressions
  • Works across all timelines

Additional Resources