Universal Profile Management
Sync your project's profile across all social media platforms automatically
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 SupportName, bio, website sync
160 chars bio, 50 char nameBluesky
✅ Full SupportName, bio, website sync
256 chars bio, 64 char nameMastodon
✅ Full SupportName, bio, website field sync
500 chars bio, 30 char nameBio and website sync (business accounts)
150 chars bio, 30 char nameDiscord
🔄 Bot UsernameBot username updates only
190 chars bio, 32 char nameAdvanced 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