Contribute
We ❤️ contributions! Whether you're fixing a bug, improving docs, or suggesting a cool new feature — you're making Social Media Downloader better for everyone. Thank you!
How to Contribute¶
Follow these steps to get started:
- Fork the repository on GitHub
- Create a new branch (e.g.,
fix-typo-in-readmeoradd-linux-support) - Make your changes (see guidelines below)
- Push to your fork
- Open a Pull Request (PR) — and we’ll review it!
Don’t worry if you’re new to open source — we welcome first-time contributors!
Before You Submit a PR¶
Please ensure your pull request follows these basic guidelines:
| Requirement | Details |
|---|---|
| ✅ Clean, linted code | Use consistent naming, remove unused code, and keep things neat |
| ✅ No breaking changes | Your changes should not break existing features or flow |
| ✅ Add helpful comments (if needed) | Especially if the logic is complex |
| ❌ Don’t include compiled files | No .exe, .bin, .deb, or other binaries in PRs — those are built via GitHub Actions |
Important
Do not include built artifacts like .exe, binary, or .deb files in your pull request.
All official releases are compiled and published automatically using GitHub Actions.
If you want to improve the build process, feel free to contribute to our workflow instead!
Where You Can Contribute¶
You don’t have to be a Python guru to help! Here's how you can contribute:
- Bug Fixes — Fix typos, broken code, or unexpected behavior
- Platform Support — Add compatibility for more systems or terminals
- Documentation — Improve setup guides, usage instructions, or examples
- Features — Add new capabilities or CLI improvements
- Testing — Help test on various OSes and report issues
Helpful Docs¶
Check out these related pages before contributing:
Need Help?¶
If you're stuck, unsure, or have questions — open a Discussion or file an Issue. We're here to support you.
Thanks for helping us grow. Let's build something awesome together!