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
114
README-FR.md
114
README-FR.md
@@ -1,114 +0,0 @@
|
|||||||
# Freedom Loader
|
|
||||||
|
|
||||||
<!-- Release -->
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<!-- Build (Next Release) -->
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
> Ce projet a pour but de permettre le téléchargement de contenu Vidéo/Audio de manière gratuite, open source et libre.
|
|
||||||
|
|
||||||
## 🚀 Fonctionnalités
|
|
||||||
|
|
||||||
- ✅ Téléchargement de vidéos avec les métadonnées (MP4)
|
|
||||||
- ✅ Téléchargement audio uniquement, avec la couverture ainsi que les métadonnées (MP3)
|
|
||||||
- ✅ Support des playlists complètes
|
|
||||||
- ✅ Récupération automatique des métadonnées (titre, durée, etc.)
|
|
||||||
- ✅ Logs détaillés : console et fichiers rotatifs (7 jours)
|
|
||||||
- ✅ Choix du chemin de sortie personnalisé avec sauvegarde
|
|
||||||
- ✅ Plusieurs thèmes graphiques au choix pour personnaliser l’interface
|
|
||||||
- ✅ Interface simple, intuitive
|
|
||||||
- ✅ Notification quand le téléchargement est fini (Click = Ouverture Dossier Output)
|
|
||||||
- ✅ Discord Rich Presence
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔧 Installation
|
|
||||||
|
|
||||||
Pour installer l'application, il vous suffit de télécharger l'installateur dans la section releases, de prendre la dernière version et de l'exécuter.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ❓ Questions fréquentes
|
|
||||||
|
|
||||||
### _Où se situent mes fichiers une fois téléchargés ?_
|
|
||||||
|
|
||||||
Dans le dossier Téléchargements (**C:\Users\VOTRE NOM\Downloads**) de votre ordinateur, dans un dossier nommé **Freedom Loader Output**
|
|
||||||
<br>
|
|
||||||
|
|
||||||
### _Une fois le programme installé et lancé, j'ai une erreur_
|
|
||||||
|
|
||||||
Essayez de relancer l'application, de consulter les logs ou d'ouvrir la console de développement du navigateur en faisant le raccourci `CTRL + SHIFT + I` ou via `View > Toggle Developer Tools`.
|
|
||||||
|
|
||||||
<!--  -->
|
|
||||||
<p align="center">
|
|
||||||
<img src="build/example-developertools.png" alt="Exemple Developer Tools" />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
## 🏗️ Fonctionnalités à venir (Roadmap)
|
|
||||||
|
|
||||||
- [ ] Plus de choix de formats
|
|
||||||
- [ ] Support des sous-titres
|
|
||||||
- [ ] Meilleure UI / UX
|
|
||||||
- [ ] Choix des langues
|
|
||||||
- [ ] Téléchargement d’une partie de la vidéo
|
|
||||||
- [ ] Renommage du fichier de sortie
|
|
||||||
- [x] ~~Extraction / découpage de la vidéo via chapitrage natif~~
|
|
||||||
- [ ] Téléchargements parallèles
|
|
||||||
- [ ] Suppression automatique des parties sponsorisées (skip sponsor)
|
|
||||||
- [x] ~~Choix personnalisé du chemin de sortie (par défaut **C:\Users\Utilisateur\Downloads**, où un dossier **Freedom Loader Output** sera créé)~~
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🖼️ Aperçu
|
|
||||||
|
|
||||||
<p align="center">
|
|
||||||
<img src="build/apercu1.0.1.png" alt="Exemple d'application" />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
> Voici un exemple de l’application lancée après avoir saisi une URL.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ℹ️ À propos
|
|
||||||
|
|
||||||
Ce projet a été réalisé en utilisant [](https://github.com/yt-dlp/yt-dlp)
|
|
||||||
Merci à eux de nous permettre d’utiliser leur API gratuitement et en open source.
|
|
||||||
|
|
||||||
Ce projet est open source et accueille volontiers vos contributions.
|
|
||||||
Voici comment participer :
|
|
||||||
|
|
||||||
- **🪲 Signalement de bugs**
|
|
||||||
Merci d’utiliser le [système d’issues GitHub](https://github.com/MasterAcnolo/Freedom-Loader/issues) pour remonter les bugs rencontrés.
|
|
||||||
Essayez de fournir une reproduction claire et les logs si possible. Les logs se trouvent dans le dossier d’installation du programme. Exemple de chemin :
|
|
||||||
`C:\Users\[VOTRE NOM]\Desktop\Freedom Loader\resources\app\logs`
|
|
||||||
Le fichier aura un nom du type `combined-20xx-xx-xx.log`.
|
|
||||||
<br>
|
|
||||||
- **🛠️ Contribution**
|
|
||||||
Les Pull Requests sont les bienvenues ! Merci de forker le repo et de soumettre votre PR après avoir vérifié le respect des guidelines (tests, style, etc.).
|
|
||||||
<br>
|
|
||||||
- **💡 Suggestions de fonctionnalités**
|
|
||||||
Vous pouvez proposer de nouvelles idées via une [issue de type feature request](https://github.com/MasterAcnolo/Freedom-Loader/issues).
|
|
||||||
Toute proposition claire et détaillée sera étudiée.
|
|
||||||
<br>
|
|
||||||
- **💰 Soutenir le projet**
|
|
||||||
<p>
|
|
||||||
Si vous souhaitez m’encourager, vous pouvez faire un don sur
|
|
||||||
<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>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📄 Licence
|
|
||||||
|
|
||||||
Ce projet est sous licence **MIT** — voir le fichier [LICENSE](./LICENSE) pour plus d’informations.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⚠️ Disclaimer
|
|
||||||
|
|
||||||
J’ai bien évidemment eu recours à l’IA pour m’aider sur certaines parties du projet. Utilisez l’IA avec parcimonie et soyez toujours conscient de ce que vous faites.
|
|
||||||
158
README.md
158
README.md
@@ -1,114 +1,134 @@
|
|||||||
# Freedom Loader
|
# Freedom Loader
|
||||||
|
|
||||||
<!-- Release -->
|
|
||||||
|
|
||||||
|
|
||||||
|
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.
|
||||||
<!-- Build (Next Release) -->
|
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.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
> 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
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔧 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">
|
<p align="center">
|
||||||
<img src="build/example-developertools.png" alt="Example Developer Tools" />
|
<img src="build/example-developertools.png" width="80%" />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## 🏗️ Upcoming Features (Roadmap)
|
---
|
||||||
|
|
||||||
|
## Roadmap
|
||||||
|
|
||||||
|
- [ ] Website for Freedom Loader
|
||||||
- [ ] More format options
|
- [ ] 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
|
- [ ] Subtitle support
|
||||||
- [ ] Improved UI / UX
|
- [ ] UI/UX improvements
|
||||||
- [ ] Language selection
|
- [ ] Language selection
|
||||||
- [ ] Download a specific part of the video
|
- [ ] Download specific parts of a video
|
||||||
- [ ] Rename output file
|
- [ ] Custom file naming
|
||||||
- [x] ~~Extract / Split video using native chapters~~
|
|
||||||
- [ ] Parallel downloads
|
- [ ] Parallel downloads
|
||||||
- [ ] Skip sponsored parts of videos
|
- [ ] Automatic sponsor skipping
|
||||||
- [x] ~~Custom output path selection (default **C:\Users\Username\Downloads** with a **Freedom Loader Output** folder created)~~
|
- [x] Extract/split video using native chapters
|
||||||
|
- [x] Custom output path selection
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🖼️ Preview
|
## Preview
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="build/apercu1.0.1.png" alt="Exemple d'application" />
|
<img src="build/apercu1.0.1.png" width="80%" />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
> Here is an example of the app after launch and entering a URL
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ℹ️ About
|
## ℹ Technologies
|
||||||
|
|
||||||
This project was built using [](https://github.com/yt-dlp/yt-dlp)
|
This project uses:
|
||||||
Thanks to them for providing a free and open-source API.
|
[](https://github.com/yt-dlp/yt-dlp)
|
||||||
|
|
||||||
This project is open-source and welcomes your contributions.
|
Huge thanks to the yt-dlp team for providing an outstanding open-source tool.
|
||||||
Here is how to get involved:
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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:
|
||||||
|
|
||||||
- **🪲 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">
|
<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">
|
<img src="https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" />
|
||||||
</a>
|
</a>
|
||||||
</p>
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📄 License
|
## License
|
||||||
|
|
||||||
This project is licensed under the **GNU License** — see the [LICENSE](./LICENSE) file for details.
|
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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⚠️ Disclaimer
|
## Note
|
||||||
|
|
||||||
I have obviously used AI assistance for some parts of this project. Use AI sparingly and always be aware of what you are doing.
|
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