bllackbull/Songbird
bllackbull/Songbird has 136 GitHub stars and 25 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-16 18:54 UTC. Last push 2026-11-15.
What you can do
- π¬ Chat Types: Direct messages, groups, and channels
- π Media Support: File uploads, voice messages, video transcoding
- π Push Notifications: Web push with VAPID
- π Voice & Video Calls: Real-time peer-to-peer and secure voice and video calling
Measured star growth
- in 24h
- +1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A secure, lightweight and self-hostable chat platform.
Self-hostedREADME.md
OriginalKey Features
- π¬ Chat Types: Direct messages, groups, and channels
- π Media Support: File uploads, voice messages, video transcoding
- π Push Notifications: Web push with VAPID
- π Voice & Video Calls: Real-time peer-to-peer and secure voice and video calling
- π‘ Remote Channels: Mirror Telegram or Songbird channels (v0.10.3+)
- π‘οΈ Admin Panel: Full management interface with owner role (v0.11.0+)
- π Security: Encryption at rest, bcrypt hashing, rate limiting
- π± PWA: Installable progressive web app
- βοΈ Cloud Deployment: PaaS and CaaS deployment with object storage support
- π i18n: English and Persian/Farsi support
Quick Start
The easiest way to install Songbird is the deployment script. On an Ubuntu server (22.04+) with sudo access, run:
curl -fsSL https://raw.githubusercontent.com/bllackbull/Songbird/main/scripts/install.sh | bash
The script handles dependencies, builds the app, configures Nginx, and can set up SSL for you. After installation, access it again anytime with:
songbird-deploy
[!TIP] A domain name pointing to your server's public IP is recommended, and HTTPS is required for push notifications (except on
localhost).
Documentation
Full documentation lives at docs.songbird.website:
- Deployment Script
- Install via Docker
- Cloud Deployment
- Manual Installation
- Configure Nginx
- SSL Certificates
- Running behind a CDN
- Running behind a domain + subpath
- Environment Variables
- Object Storage
- Media Worker
- Admin Panel
- Remote Channel Setup
- Push Notification Proxy
- Voice & Video Calls
- Updating the deployed app
- Database Commands
- Troubleshooting
Author
- Maintainer: @bllackbull
- Contributors: @nkhalili, @modos, @iPmartNetwork
Contributing
- Contributions are welcome.
- If you want to contribute, contact the maintainer first by opening an issue at:
https://github.com/bllackbull/Songbird/issues - For direct coordination, reach out to @bllackbull on GitHub before opening a PR.
- Checkout Contributing guideline for more information.
Support
If you like this project which I hope you do, consider supporting your favorite project:
TRX:
TPf1bEhipKpGkjo5N2Scj9nufNNh5TNrwX
BTC:
bc1q9hupvcc39juhf0k7rgzn6phn8s8jez365kzmuj
TON:
UQDzQ3xbWzKQvw8X8sWU82dksBeYqTHrT9sLzhBOyaESPjVy
License
This project is licensed under the MIT License. See the LICENSE file for details.