{"id":25922211,"url":"https://github.com/andreasthinks/open-social-poster","last_synced_at":"2026-06-03T22:31:24.190Z","repository":{"id":279935245,"uuid":"940238342","full_name":"AndreasThinks/open-social-poster","owner":"AndreasThinks","description":"A tool for cross-posting across Bluesky, Mastodon and X/Twitter","archived":false,"fork":false,"pushed_at":"2025-03-01T13:20:30.000Z","size":191,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-03T06:26:25.788Z","etag":null,"topics":["fasthtml","python","social-media"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AndreasThinks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-27T20:51:34.000Z","updated_at":"2025-04-16T20:50:03.000Z","dependencies_parsed_at":"2025-02-28T16:15:05.870Z","dependency_job_id":"ef7f40f6-3b1b-4b52-8621-c26a7a934437","html_url":"https://github.com/AndreasThinks/open-social-poster","commit_stats":null,"previous_names":["andreasthinks/open-social-poster"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AndreasThinks/open-social-poster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndreasThinks%2Fopen-social-poster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndreasThinks%2Fopen-social-poster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndreasThinks%2Fopen-social-poster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndreasThinks%2Fopen-social-poster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AndreasThinks","download_url":"https://codeload.github.com/AndreasThinks/open-social-poster/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndreasThinks%2Fopen-social-poster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33883102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fasthtml","python","social-media"],"created_at":"2025-03-03T16:17:47.142Z","updated_at":"2026-06-03T22:31:24.174Z","avatar_url":"https://github.com/AndreasThinks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Social Poster\n\nAn open-source, unified social media management tool that lets you post content and media to multiple platforms simultaneously.\n\n![Social Poster Screenshot](/screenshots/example_screenshot.png)\n\n## Features\n\n- **Multi-platform Support**: Post to Bluesky, Twitter/X, and Mastodon from a single interface\n- **Media Uploads**: Attach images and other media files to your posts\n- **Character Limit Checking**: Real-time validation of post length against platform limits\n\n## Installation and Running\n\nThis project uses [UV](https://docs.astral.sh/uv/) for managing Python dependencies and execution. Two convenience scripts are provided to handle UV installation and run the main script.\n\n### Windows\n\nRight click run_social_poster.ps1 and select Open in Powershell, or\n\n1. Open PowerShell\n2. Run the provided script by right clicking:\n```powershell\npowershell -ExecutionPolicy ByPass -File run_social_poster.ps1\n```\n\n### macOS/Linux\n\n1. Open a terminal\n2. Make the script executable:\n```bash\nchmod +x run_social_poster.sh\n```\n3. Run the script:\n```bash\n./run_social_poster.sh\n```\n\n## Usage\n\n1. **Connect Accounts**: First, connect to your social media accounts in the Accounts tab\n   - For Bluesky: Enter your handle and app password\n   - For Twitter/X: Login through the browser window that opens\n   - For Mastodon: Enter your instance domain and authorize the application\n\n2. **Create Posts**: Switch to the Post tab to compose your message\n   - Add media files using the upload section\n   - Type your message in the text area\n   - Select which connected accounts to post to\n\n3. **Monitor Character Limits**: The app will automatically check if your post exceeds character limits for selected platforms\n\n4. **Send**: Click the Post button to send your message to all selected platforms\n\n## Technical Details\n\nSocial Poster is built using:\n- **FastHTML**: Server-side rendering framework\n- **MonsterUI**: Component library for clean, responsive UI\n- **HTMX**: Dynamic interactions without writing JavaScript\n- **ATProto**: For Bluesky API integration\n- **Selenium**: For Twitter/X integration\n- **Mastodon API**: For Mastodon integration\n- **SQLite**: Local storage of account information\n\n## Troubleshooting\n\n- **Connection Issues**: Ensure you have a stable internet connection and that the social media services are accessible.\n- **Authentication Failures**: For Bluesky, verify you're using a valid app password. For Twitter, ensure your account is not locked.\n- **Upload Problems**: Check that your media files are in supported formats and under size limits.\n- **Browser Issues**: For Twitter integration, ensure Chrome is installed and up to date.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreasthinks%2Fopen-social-poster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandreasthinks%2Fopen-social-poster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreasthinks%2Fopen-social-poster/lists"}