https://github.com/adel-bakhshi/crossplatformdownloadmanager
A fast, open-source, and feature-rich download manager for Windows, Linux, and macOS with multi-threading, queue support, and browser integration
https://github.com/adel-bakhshi/crossplatformdownloadmanager
avalonia avalonia-ui avaloniaui axaml cross-platform csharp download download-manager downloader downloadmanager
Last synced: 4 months ago
JSON representation
A fast, open-source, and feature-rich download manager for Windows, Linux, and macOS with multi-threading, queue support, and browser integration
- Host: GitHub
- URL: https://github.com/adel-bakhshi/crossplatformdownloadmanager
- Owner: adel-bakhshi
- License: agpl-3.0
- Created: 2024-08-17T07:30:01.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-10-04T05:09:56.000Z (9 months ago)
- Last Synced: 2025-10-04T07:10:59.495Z (9 months ago)
- Topics: avalonia, avalonia-ui, avaloniaui, axaml, cross-platform, csharp, download, download-manager, downloader, downloadmanager
- Language: C#
- Homepage: https://cdmapp.netlify.app
- Size: 6.74 MB
- Stars: 47
- Watchers: 2
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: LICENSE
Awesome Lists containing this project
README
# 🌐 Cross Platform Download Manager (CDM)
---
---
## About CDM
**Cross Platform Download Manager (CDM)** is a **fast, free, and open-source download manager** designed to provide a seamless downloading experience across multiple operating systems.
### Tagline:
_"A fast, free, and open-source download manager for Windows, macOS, and Linux."_
---
## 📦 Built & Packaged with Netloy
**CDM** leverages the power of **[Netloy](https://github.com/adel-bakhshi/Netloy)** — a cutting-edge cross-platform .NET packaging and deployment tool — to deliver professional installers across Windows, Linux, and macOS platforms with zero hassle.
### Why Netloy?
Netloy eliminates the complexity of creating platform-specific packages by automating the entire build and deployment pipeline. With a single configuration file, CDM generates:
- **Windows:** MSI and EXE installers (WiX v3 & Inno Setup)
- **Linux:** DEB, RPM, AppImage, Flatpak, and Pacman packages
- **macOS:** APP bundles and DMG installers
- **Portable:** Cross-platform ZIP/TAR.GZ archives
### Automated CI/CD Integration
CDM's release process is fully automated using **GitHub Actions** and Netloy. Every release automatically:
- Builds the application for all target platforms
- Generates platform-specific installers with proper metadata and icons
- Creates desktop integration files and AppStream metadata
- Publishes release artifacts to GitHub Releases
This automation ensures consistent, reliable releases across all platforms without manual intervention. Check out our [CI/CD workflow](https://github.com/adel-bakhshi/CrossPlatformDownloadManager/blob/master/.github/workflows/dotnet-desktop.yml) to see Netloy in action!
### Want to Simplify Your .NET Deployment?
If you're building cross-platform .NET applications and struggling with complex packaging requirements, **[Netloy](https://github.com/adel-bakhshi/Netloy)** can help you achieve the same level of automation and professionalism. Say goodbye to manual build scripts and platform-specific headaches!
---
## 📸 Screenshots
Below are some screenshots showcasing the key features of CDM:
Main Interface
Download
Settings
---
## 📥 Installation
Getting started with **Cross Platform Download Manager (CDM)** is simple! Follow these steps to install both the main application and the browser extension.
### **1. Install the Main Application**
1. Visit the [Releases Page](https://github.com/adel-bakhshi/CrossPlatformDownloadManager/releases).
2. Download the latest version of CDM for your operating system (Windows, macOS, or Linux).
3. Run the installer or extract the files (depending on your platform).
4. Launch the program and start managing your downloads!
That's it! No additional prerequisites or setup required.
### **2. Install the Browser Extension**
Since we haven't been able to publish the browser extension on the Chrome Web Store due to an embargo, you can manually install it by following these steps:
#### **For Google Chrome and Other Chromium-Based Browsers:**
1. **Download the Extension:** Visit the [Extension Releases Page](https://github.com/adel-bakhshi/cdm-browser-extension/releases) and download the latest `.crx` file.
2. **Open Extensions Settings:** In your browser, navigate to `chrome://extensions/` in the address bar.
3. **Enable Developer Mode:** Toggle the **Developer Mode** switch located in the top-right corner of the page.
4. **Install the Extension:**
- Drag and drop the downloaded `.crx` file directly into the extensions page.
- Alternatively, if you have an unpacked folder containing the extension files, click **Load Unpacked** and select the folder.
5. **You're All Set!** The extension will now be installed and ready to use in your Chromium-based browser.
> **Note:** While this method works for most Chromium-based browsers (e.g., Microsoft Edge, Brave, Vivaldi, Opera), some browsers might have slightly different settings or interfaces. If you encounter any issues, refer to your browser's documentation or let us know by [reporting the issue](https://github.com/adel-bakhshi/cdm-browser-extension/issues).
#### **For Firefox:**
1. **Download the Extension:**
Visit the [official Mozilla Add-ons page](https://addons.mozilla.org/en-US/firefox/addon/cdm-browser-extension/) and click the **Add to Firefox** button.
2. **Install the Extension:**
After clicking **Add to Firefox**, follow the prompts to complete the installation. Once installed, the extension will appear in your list of add-ons.
3. **You're All Set!** The extension will now be installed and ready to use in Firefox.
> **Note:** The Firefox extension is fully supported and maintained under the same GitHub project as the Chromium-based extension: [Github project link](https://github.com/adel-bakhshi/cdm-browser-extension). Release updates are synchronized across both platforms.
---
### Additional Notes:
- Both the Chromium-based and Firefox extensions are built and maintained under the same GitHub project. This ensures consistent functionality and updates across all supported browsers.
- If you encounter any issues during installation or usage, please [report the issue](https://github.com/adel-bakhshi/cdm-browser-extension/issues) so we can assist you.
---
## 🎨 Custom Themes
CDM supports custom themes to personalize your experience. You can:
- Use built-in dark/light themes
- Create your own custom themes
- Share themes with the community
For detailed instructions on creating and applying custom themes, see our [Theme Customization Guide](./Assets/MarkDown/THEME_GUIDE.md).
## ✨ Features & Enhancements
**Cross Platform Download Manager (CDM)** is packed with powerful features designed to enhance your downloading experience:
- **Free & Open Source:** Use it without restrictions, and contribute to its development under the AGPL-3 license.
- **Cross-Platform Support:** Works seamlessly on Windows, macOS, and Linux.
- **Faster Download Speeds:** Utilizes multi-threaded downloading for maximum efficiency.
- **Download Queues:** Manage multiple downloads effortlessly with automatic queue processing.
- **Browser Extension:** Capture download links directly from Google Chrome, Firefox, and other Chromium-Based Browsers.
- **Pause & Resume:** Temporarily stop downloads and resume them later without losing progress.
- **Speed Limiting:** Control bandwidth usage by setting download speed caps.
- **User-Friendly Interface:** Intuitive design for both beginners and advanced users.
- **Customizable Settings:** Fine-tune the manager to suit your specific needs.
- **Wide File Type Support:** Handles videos, music, documents, archives, and more.
We're continuously improving CDM based on user feedback, so stay tuned for exciting updates!
---
## ⚠️ Known Issues or Limitations
While we strive to make CDM as robust and efficient as possible, there are a few known limitations:
- **Stopping Downloads May Slow Down the Program:** In certain cases, stopping ongoing downloads may cause the program to temporarily slow down. We are actively working on resolving this issue but haven't found a solution yet.
If you encounter any other issues, please report them via the [GitHub Issues Page](https://github.com/adel-bakhshi/CrossPlatformDownloadManager/issues).
---
## ❤️ Support the Project
If you find **Cross Platform Download Manager (CDM)** useful and would like to support its development, consider making a donation. Your contributions help cover development costs and ensure the continued improvement of the program.
Donate via Bitcoin
Donate via Ethereum
Donate via Tether
Bitcoin Address:
bc1qx3cyervg9wrrpqtr65ew5h7a9h2dnl5n7eul9k
Ethereum Address:
0x6D66BdD07EBA5876f1E4E96B96237C0F272c3F27
Tether Address:
TC7CtsRLgX1aWrKL1eVKMwc9TCXyBkNheu
Thank you for your support! Every contribution makes a difference and helps keep CDM free and open-source for everyone.
---
## 🤝 Contributing
We welcome contributions from the community! Whether you're reporting bugs, suggesting features, or submitting code, every contribution helps improve CDM. To get started:
1. Fork the repository.
2. Create a new branch for your changes (`git checkout -b feature/new-feature`).
3. Commit your changes (`git commit -m "Add new feature"`).
4. Push to the branch (`git push origin feature/new-feature`).
5. Submit a pull request detailing your updates.
For more details, see the project's [GitHub Page](https://github.com/adel-bakhshi/CrossPlatformDownloadManager).
---
## 📜 License
This project is licensed under the terms of the [AGPL-3 License](https://github.com/adel-bakhshi/CrossPlatformDownloadManager?tab=AGPL-3.0-1-ov-file#). Feel free to use, modify, and distribute the software as per the license agreement.
---
## 📧 Contact Information
If you have any questions, feedback, or need support, feel free to contact me through the following channels:
- Email: [adelbakhshi78@yahoo.com](mailto:adelbakhshi78@yahoo.com)
- Telegram: [https://t.me/ADdy2142](https://t.me/ADdy2142)
- GitHub: [https://github.com/adel-bakhshi](https://github.com/adel-bakhshi)
I'm always happy to help!
---
## 🙏 Credits & Acknowledgments
A big thank-you to all the developers and contributors who have made this project possible by providing their excellent libraries and tools for free. Special mentions include:
- **[Avalonia UI](https://avaloniaui.net/):** A cross-platform XAML-based UI framework.
- **[JetBrains](https://www.jetbrains.com/):** For providing top-notch development tools.
- **[Downloader](https://github.com/bezzad/Downloader):** A powerful library for handling downloads efficiently.
Additionally, I extend my gratitude to the broader open-source community for their continuous support and inspiration. Your efforts make projects like CDM possible!
---
## 📊 Roadmap & Future Plans
We're committed to making CDM better with every update. Here are some ideas we're exploring for future releases:
### **For CDM:**
- **System Notifications:** Implement native system notifications for download completions and errors.
- **Multilingual Support:** Make the program available in multiple languages to reach a global audience.
### **For the Browser Extension:**
- **Publishing the Extension:** We are actively working on publishing the extension to the Chrome Web Store. While we've encountered some challenges, your support and patience will help us complete this process.
Stay tuned for updates, and feel free to suggest features you'd like to see!