# Freedom Loader

<!-- Release -->

![Static Badge](https://img.shields.io/badge/Release-1.2-blue?style=flat&logo=Test)

<!-- Build (Next Release) -->

![Static Badge](https://img.shields.io/badge/Build-1.2.1--beta-yellow?style=flat&logo=Test)

> 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 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

---

## 🔧 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`

<!-- ![Example Path](build/example-developertools.png) -->
<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
- [x] ~~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 [![yt-dlp](https://img.shields.io/badge/yt--dlp-Visit%20Repo-181717?style=for-the-badge&logo=github&logoColor=white)](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.
