From 5bb7ca377dbd9c24f2534b459f939f6c4c01ae5f Mon Sep 17 00:00:00 2001 From: MasterAcnolo <68693319+MasterAcnolo@users.noreply.github.com> Date: Sat, 8 Nov 2025 14:05:15 +0100 Subject: [PATCH] Removed ReadME FR and Rework ReadME --- README-FR.md | 114 ------------------------------------ README.md | 160 +++++++++++++++++++++++++++++---------------------- 2 files changed, 90 insertions(+), 184 deletions(-) delete mode 100644 README-FR.md diff --git a/README-FR.md b/README-FR.md deleted file mode 100644 index da31189..0000000 --- a/README-FR.md +++ /dev/null @@ -1,114 +0,0 @@ -# Freedom Loader - - - -![Static Badge](https://img.shields.io/badge/Release-1.2.4-blue?style=flat&logo=Test) - - - -![Static Badge](https://img.shields.io/badge/Build-1.2.5--beta-yellow?style=flat&logo=Test) - -> 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** -
- -### _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`. - - -

- Exemple Developer Tools -

- -## 🏗️ 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 - -

- Exemple d'application -

- -> Voici un exemple de l’application lancée après avoir saisi une URL. - ---- - -## ℹ️ À propos - -Ce projet a été réalisé en utilisant [![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) -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`. -
-- **🛠️ 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.). -
-- **💡 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. -
-- **💰 Soutenir le projet** -

- Si vous souhaitez m’encourager, vous pouvez faire un don sur - - PayPal - -

- ---- - -## 📄 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. diff --git a/README.md b/README.md index a7ec6d7..d2996fe 100644 --- a/README.md +++ b/README.md @@ -1,114 +1,134 @@ # Freedom Loader - +![Static Badge](https://img.shields.io/badge/Release-1.2.4-blue?style=flat) +![Static Badge](https://img.shields.io/badge/Build-1.2.5--beta-yellow?style=flat) -![Static Badge](https://img.shields.io/badge/Release-1.2.4-blue?style=flat&logo=Test) - - - -![Static Badge](https://img.shields.io/badge/Build-1.2.5--beta-yellow?style=flat&logo=Test) - -> 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** -
+--- -### _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”. -

- Example Developer Tools +

-## 🏗️ 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

- Exemple d'application +

-> Here is an example of the app after launch and entering a URL +--- + +## ℹ Technologies + +This project uses: +[![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) + +Huge thanks to the yt-dlp team for providing an outstanding open-source tool. --- -## ℹ️ About +## Contributing -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. +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` -
-- **🛠️ Contribution** - Pull Requests are welcome! Please fork the repo and submit your PR after ensuring you meet the contribution guidelines (tests, style, etc.). -
-- **💡 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. -
-- **💰 Support the Project** -

- If you'd like to support me, you can donate via - - PayPal - -

+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: + + + + --- -## ⚠️ 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.