mirror of
https://github.com/MasterAcnolo/Freedom-Loader.git
synced 2026-07-29 18:25:47 +02:00
136 lines
3.7 KiB
Markdown
136 lines
3.7 KiB
Markdown
# Freedom Loader
|
||
|
||
|
||
|
||
<!--  -->
|
||
|
||
Freedom Loader is a Windows desktop application built with Electron.
|
||
It provides a simple and reliable way to download video or audio content with metadata and advanced options, without ads or questionable third-party services.
|
||
The goal is to offer a clean, user-friendly, and transparent download experience. It's important for me to make media content downloading accessible to people who love music or videos and don’t always have an internet connection.
|
||
|
||
---
|
||
|
||
## Features
|
||
|
||
- Video download with metadata (MP4)
|
||
- Audio-only download with thumbnail and tags (MP3)
|
||
- Full playlist support
|
||
- Automatic metadata retrieval (title, duration, author, etc.)
|
||
- Detailed logs (console + rotating files for 7 days)
|
||
- Custom output path with persistence
|
||
- Automatic dependency updates (YT-DLP)
|
||
- Multiple UI themes
|
||
- Simple, responsive interface
|
||
- Notifications on download completion (click to open folder)
|
||
- Discord Rich Presence
|
||
|
||
---
|
||
|
||
## Installation
|
||
|
||
Download the latest installer from the **Releases** page and run it (Defender could stop you but click on "Run Anyway" and it's good).
|
||
No additional setup is required.
|
||
|
||
---
|
||
|
||
## FAQ
|
||
|
||
### Where are my downloaded files stored?
|
||
|
||
In your **Downloads** folder, inside **Freedom Loader**.
|
||
Example path:
|
||
`C:\Users\[YOUR NAME]\Downloads\Freedom Loader`
|
||
|
||
### I get an error after launching the app
|
||
|
||
Try restarting the application, checking the logs, or opening the developer console:
|
||
`CTRL + SHIFT + I` -> “Toggle Developer Tools”.
|
||
|
||
<p align="center">
|
||
<img src="build/example-developertools.png" width="20%" />
|
||
</p>
|
||
|
||
---
|
||
|
||
## Roadmap
|
||
|
||
- [ ] Website for Freedom Loader
|
||
- [ ] More format options
|
||
- [ ] Linux version
|
||
- [ ] Mobile version (APK)
|
||
- [x] ~~Auto-updating YT-DLP~~
|
||
- [ ] Automatic project updates
|
||
- [ ] Better download status
|
||
- [ ] Better website support (currently only YouTube is fully supported)
|
||
- [ ] Subtitle support
|
||
- [ ] UI/UX improvements
|
||
- [ ] Language selection
|
||
- [ ] Download specific parts of a video
|
||
- [ ] Custom file naming
|
||
- [ ] Parallel downloads
|
||
- [ ] Automatic sponsor skipping
|
||
- [x] ~~Extract/split video using native chapters~~
|
||
- [x] ~~Custom output path selection~~
|
||
|
||
---
|
||
|
||
## Preview
|
||
|
||
<p align="center">
|
||
<img src="build/apercu1.0.1.png" width="80%" />
|
||
</p>
|
||
|
||
---
|
||
|
||
## Technologies
|
||
|
||
This project uses:
|
||
[](https://github.com/yt-dlp/yt-dlp)
|
||
|
||
Huge thanks to the yt-dlp team for providing an outstanding open-source tool.
|
||
|
||
---
|
||
|
||
## Contributing
|
||
|
||
Contributions are welcome.
|
||
|
||
### Bug Reports
|
||
|
||
Use the GitHub Issues system and include reproduction steps and logs when possible.
|
||
Logs can be found here:
|
||
`C:\Users\[USERNAME]\Desktop\Freedom Loader\resources\app\logs\combined-20xx-xx-xx.log`
|
||
|
||
### Feature Requests
|
||
|
||
Open a feature request issue with a clear description and use cases.
|
||
|
||
### Pull Requests
|
||
|
||
Fork the repository, make your changes, and submit a PR once everything is tested and clean.
|
||
|
||
---
|
||
|
||
## Support the Project
|
||
|
||
If you'd like to support development:
|
||
|
||
<a href="https://paypal.me/axelnicolas25">
|
||
<img src="https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" />
|
||
</a>
|
||
|
||
---
|
||
|
||
## License
|
||
|
||
Freedom Loader is released under the **GNU General Public License v3.0 (GPLv3)**.
|
||
You are free to use, modify, and redistribute the software under the terms of this license.
|
||
|
||
See the full license in the [LICENSE](./LICENSE) file.
|
||
|
||
---
|
||
|
||
## Note
|
||
|
||
AI assistance was used occasionally to speed up development, but all code and decisions were reviewed and validated manually.
|