Universal Profile Management

Sync your project's profile across all social media platforms automatically

✨ New in v1.5.0

Overview

Multi-Platform Support

Unified profile management across Twitter, Bluesky, Mastodon, Instagram, and Discord

Auto-Optimization

Automatically adapts content to each platform's character limits and requirements

Single Configuration

One YAML file controls all your social media profiles

Quick Start

1. Add Profile Configuration

# campaign.yaml
name: "my-awesome-project"
platforms:
  - twitter
  - bluesky
  - mastodon
  - instagram

# Add profile configuration
profile:
  display_name: "My Awesome Project"
  bio: "🚀 Revolutionary AI tool | Open Source | Developer-friendly"
  website: "https://github.com/user/my-project"
  sync_on_apply: true  # Enable automatic profile updates

2. Preview Profile Updates

aetherpost plan

This shows your campaign content and profile updates that will be applied.

3. Apply Everything at Once

aetherpost apply

Posts your campaign content and updates profiles on all configured platforms.

Platform Support

Twitter/X

✅ Full Support

Name, bio, website sync

160 chars bio, 50 char name

Bluesky

✅ Full Support

Name, bio, website sync

256 chars bio, 64 char name

Mastodon

✅ Full Support

Name, bio, website field sync

500 chars bio, 30 char name

Instagram

✅ Bio + Website

Bio and website sync (business accounts)

150 chars bio, 30 char name

Discord

🔄 Bot Username

Bot username updates only

190 chars bio, 32 char name

Advanced Configuration

Platform-Specific Overrides

profile:
  display_name: "AetherPost"
  bio: "Default bio for most platforms"
  website: "https://aetherpost.dev"
  
  # Override for specific platforms
  overrides:
    twitter:
      bio: "🚀 Social automation for devs. 5 platforms, 1 command."
    instagram:
      bio: "AI-powered social media automation 🤖"

Conditional Profile Updates

profile:
  display_name: "My Project"
  bio: "Amazing developer tool"
  website: "https://github.com/user/project"
  sync_on_apply: false  # Disable auto-sync
  
# Manual profile sync
manual_profile_sync: true

Best Practices

Keep it Concise

Short, impactful bios work best across all platforms. Use the shortest platform's limit as your guide.

Use Emojis

Emojis stand out and save characters. They're universally supported across all platforms.

Include Keywords

Help people find your project by including relevant keywords in your bio.

Update Regularly

Keep profiles fresh with project updates, new features, or achievements.

Troubleshooting

Profile Not Updating

  • Check API credentials in .env.aetherpost
  • Verify platform permissions (Instagram requires business accounts)
  • Run aetherpost doctor to diagnose issues

Character Limit Issues

  • AetherPost auto-truncates content, but review the results
  • Use platform-specific overrides for custom text
  • Remove less important information first

API Rate Limits

  • Profile updates count against API limits
  • Space out updates if hitting limits
  • Disable sync_on_apply for high-frequency posting

Ready to Unify Your Social Media Presence?