mirror of
https://github.com/MasterAcnolo/Freedom-Loader.git
synced 2026-07-29 18:25:47 +02:00
114 lines
3.9 KiB
Markdown
114 lines
3.9 KiB
Markdown
# Freedom Loader
|
||
|
||
<!-- Release -->
|
||
|
||
|
||
|
||
<!-- Build (Next Release) -->
|
||
|
||
|
||
|
||
> This project aims to enable free, open-source, and unrestricted downloading of Video/Audio content. Eventually, it will allow users to choose
|
||
|
||
## 🚀 Features
|
||
|
||
- ✅ Video download (MP4)
|
||
- ✅ Audio-only download (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)
|
||
|
||
---
|
||
|
||
## 🔧 Installation
|
||
|
||
To install the application, simply download the installer from the releases section. Take the latest version and run it.
|
||
|
||
---
|
||
|
||
## ❓ Frequently Asked Questions
|
||
|
||
### _Where are my downloaded files located?_
|
||
|
||
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_
|
||
|
||
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`
|
||
|
||
<!--  -->
|
||
<p align="center">
|
||
<img src="build/example-developertools.png" alt="Example Developer Tools" />
|
||
</p>
|
||
|
||
## 🏗️ Upcoming Features (Roadmap)
|
||
|
||
- [ ] More format options
|
||
- [ ] Subtitle support
|
||
- [ ] Improved UI / UX
|
||
- [ ] Language selection
|
||
- [ ] Download a specific part of the video
|
||
- [ ] Rename output file
|
||
- [ ] Extract / Split video using native chapters
|
||
- [ ] Parallel downloads
|
||
- [ ] Skip sponsored parts of videos
|
||
- [x] ~~Custom output path selection (default **C:\Users\Username\Downloads** with a **Freedom Loader Output** folder created)~~
|
||
|
||
---
|
||
|
||
## 🖼️ Preview
|
||
|
||
<p align="center">
|
||
<img src="build/apercu1.0.1.png" alt="Exemple d'application" />
|
||
</p>
|
||
|
||
> Here is an example of the app after launch and entering a URL
|
||
|
||
---
|
||
|
||
## ℹ️ About
|
||
|
||
This project was built using [](https://github.com/yt-dlp/yt-dlp)
|
||
Thanks to them for providing a free and open-source API.
|
||
|
||
This project is open-source and welcomes your contributions.
|
||
Here is how to get involved:
|
||
|
||
- **🪲 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>
|
||
|
||
---
|
||
|
||
## 📄 License
|
||
|
||
This project is licensed under the **MIT License** — see the [LICENSE](./LICENSE) file for details.
|
||
|
||
---
|
||
|
||
## ⚠️ Disclaimer
|
||
|
||
I have obviously used AI assistance for some parts of this project. Use AI sparingly and always be aware of what you are doing.
|