mirror of
https://github.com/MasterAcnolo/Freedom-Loader.git
synced 2026-07-29 18:25:47 +02:00
Removed ReadME FR and Rework ReadME
This commit is contained in:
MasterAcnolo
160
README.md
160
README.md
@@ -1,114 +1,134 @@
|
||||
# Freedom Loader
|
||||
|
||||
<!-- Release -->
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- Build (Next Release) -->
|
||||
|
||||
|
||||
|
||||
> This project aims to enable free, open-source, and unrestricted downloading of Video/Audio content.
|
||||
|
||||
## 🚀 Features
|
||||
|
||||
- ✅ Video download with metadata(MP4)
|
||||
- ✅ Audio-only download with thumbail and metadata(MP3)
|
||||
- ✅ Full playlist support
|
||||
- ✅ Automatic metadata retrieval (title, duration, etc.)
|
||||
- ✅ Detailed logs: console and rotating files (7 days)
|
||||
- ✅ Custom output path selection with saving
|
||||
- ✅ Multiple graphical themes available for interface customization
|
||||
- ✅ Simple, intuitive, and responsive interface
|
||||
- ✅ Notification system when download finished (Click = Open Output Folder)
|
||||
- ✅ Discord Rich Presence
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Installation
|
||||
## Features
|
||||
|
||||
To install the application, simply download the installer from the releases section. Take the latest version and run it.
|
||||
- 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
|
||||
|
||||
---
|
||||
|
||||
## ❓ Frequently Asked Questions
|
||||
## Installation
|
||||
|
||||
### _Where are my downloaded files located?_
|
||||
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.
|
||||
|
||||
In your computer's Downloads folder (**C:\Users\YOUR NAME\Downloads**), inside a folder named **Freedom Loader Output**
|
||||
<br>
|
||||
---
|
||||
|
||||
### _After installing and running the program, I get an error_
|
||||
## FAQ
|
||||
|
||||
Try restarting the application, checking the logs, or opening the browser's developer console by pressing `CTRL + SHIFT + I` or by going to `View > Toggle Developer Tools`
|
||||
### 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" alt="Example Developer Tools" />
|
||||
<img src="build/example-developertools.png" width="80%" />
|
||||
</p>
|
||||
|
||||
## 🏗️ Upcoming Features (Roadmap)
|
||||
---
|
||||
|
||||
## 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
|
||||
- [ ] Improved UI / UX
|
||||
- [ ] UI/UX improvements
|
||||
- [ ] Language selection
|
||||
- [ ] Download a specific part of the video
|
||||
- [ ] Rename output file
|
||||
- [x] ~~Extract / Split video using native chapters~~
|
||||
- [ ] Download specific parts of a video
|
||||
- [ ] Custom file naming
|
||||
- [ ] Parallel downloads
|
||||
- [ ] Skip sponsored parts of videos
|
||||
- [x] ~~Custom output path selection (default **C:\Users\Username\Downloads** with a **Freedom Loader Output** folder created)~~
|
||||
- [ ] Automatic sponsor skipping
|
||||
- [x] Extract/split video using native chapters
|
||||
- [x] Custom output path selection
|
||||
|
||||
---
|
||||
|
||||
## 🖼️ Preview
|
||||
## Preview
|
||||
|
||||
<p align="center">
|
||||
<img src="build/apercu1.0.1.png" alt="Exemple d'application" />
|
||||
<img src="build/apercu1.0.1.png" width="80%" />
|
||||
</p>
|
||||
|
||||
> Here is an example of the app after launch and entering a URL
|
||||
---
|
||||
|
||||
## ℹ 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.
|
||||
|
||||
---
|
||||
|
||||
## ℹ️ About
|
||||
## Contributing
|
||||
|
||||
This project was built using [](https://github.com/yt-dlp/yt-dlp)
|
||||
Thanks to them for providing a free and open-source API.
|
||||
Contributions are welcome.
|
||||
|
||||
This project is open-source and welcomes your contributions.
|
||||
Here is how to get involved:
|
||||
### Bug Reports
|
||||
|
||||
- **🪲 Bug Reporting**
|
||||
Please use the [GitHub issues system](https://github.com/MasterAcnolo/Freedom-Loader/issues) to report any bugs you encounter.
|
||||
Try to provide clear reproduction steps and logs if possible. Logs are located in the installation folder of the program. Example path:
|
||||
`C:\Users\[YOUR NAME]\Desktop\Freedom Loader\resources\app\logs`
|
||||
The log file will be named something like `combined-20xx-xx-xx.log`
|
||||
<br>
|
||||
- **🛠️ Contribution**
|
||||
Pull Requests are welcome! Please fork the repo and submit your PR after ensuring you meet the contribution guidelines (tests, style, etc.).
|
||||
<br>
|
||||
- **💡 Feature Suggestions**
|
||||
You can propose new ideas via a [feature request issue](https://github.com/MasterAcnolo/Freedom-Loader/issues).
|
||||
Any clear and detailed proposal will be reviewed.
|
||||
<br>
|
||||
- **💰 Support the Project**
|
||||
<p>
|
||||
If you'd like to support me, you can donate via
|
||||
<a href="https://paypal.me/axelnicolas25">
|
||||
<img src="https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal">
|
||||
</a>
|
||||
</p>
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## 📄 License
|
||||
## Support the Project
|
||||
|
||||
This project is licensed under the **GNU License** — see the [LICENSE](./LICENSE) file for details.
|
||||
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>
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Disclaimer
|
||||
## License
|
||||
|
||||
I have obviously used AI assistance for some parts of this project. Use AI sparingly and always be aware of what you are doing.
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user