{"id":13551203,"url":"https://github.com/ChocolateApp/Chocolate","last_synced_at":"2025-04-03T01:31:42.998Z","repository":{"id":43719091,"uuid":"511544789","full_name":"ChocolateApp/Chocolate","owner":"ChocolateApp","description":"The future of media manager","archived":false,"fork":false,"pushed_at":"2024-05-06T14:42:03.000Z","size":28837,"stargazers_count":414,"open_issues_count":4,"forks_count":13,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-05-06T16:15:02.337Z","etag":null,"topics":["anime","app","chocolate","chocolateapp","encoding","ffmpeg","jellyfin","local-media-server","manager","media","media-server","mediamanager","movies","plex","show","tmdb","video-player"],"latest_commit_sha":null,"homepage":"https://chocolateapp.github.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChocolateApp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-07T13:46:03.000Z","updated_at":"2024-05-29T21:25:45.427Z","dependencies_parsed_at":"2024-01-15T16:09:23.512Z","dependency_job_id":"1ab68b79-886f-420e-a616-23078f27a3e5","html_url":"https://github.com/ChocolateApp/Chocolate","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChocolateApp%2FChocolate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChocolateApp%2FChocolate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChocolateApp%2FChocolate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChocolateApp%2FChocolate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChocolateApp","download_url":"https://codeload.github.com/ChocolateApp/Chocolate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246922095,"owners_count":20855341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anime","app","chocolate","chocolateapp","encoding","ffmpeg","jellyfin","local-media-server","manager","media","media-server","mediamanager","movies","plex","show","tmdb","video-player"],"created_at":"2024-08-01T12:01:44.097Z","updated_at":"2025-04-03T01:31:42.960Z","avatar_url":"https://github.com/ChocolateApp.png","language":"Python","funding_links":[],"categories":["HarmonyOS","Python"],"sub_categories":["Windows Manager"],"readme":"\u003cp align=\"center\"\u003e\r\n    \u003cimg src=\"https://user-images.githubusercontent.com/69050895/185436929-c80736b3-07ce-434b-ba96-d753c8e9f83c.png\" height=\"300px\" width=\"575px\"\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cdiv style=\"font-style: italic; text-align: center;\" markdown=\"1\" align=\"center\"\u003e\r\n\r\n  ![wakatime](https://wakatime.com/badge/user/4cf4132a-4ced-411d-b714-67bdbdc84527/project/ecce3f45-dba9-4e4b-8f78-693c6d237d1c.svg)\r\n  [![PyPI version](https://badge.fury.io/py/chocolate-app.svg)](https://badge.fury.io/py/chocolate-app)\r\n  [![GitHub release](https://img.shields.io/github/release/ChocolateApp/Chocolate?include_prereleases=\u0026sort=semver\u0026color=blue)](https://github.com/ChocolateApp/Chocolate/releases/)\r\n  [![GitHub stars](https://img.shields.io/github/stars/ChocolateApp/Chocolate?style=social\u0026label=Stars\u0026color=blue)](https://github.com/ChocolateApp/Chocolate)\r\n  [![GitHub watchers](https://img.shields.io/github/watchers/ChocolateApp/Chocolate?style=social\u0026label=Watchers\u0026color=blue)](https://github.com/ChocolateApp/Chocolate)\r\n  [![License](https://img.shields.io/badge/License-MIT-blue)](#license)\r\n  [![issues - Chocolate](https://img.shields.io/github/issues/ChocolateApp/Chocolate)](https://github.com/ChocolateApp/Chocolate/issues)\r\n\r\n\u003c/div\u003e\r\n\r\n**Thanks everyone for the support, I'm still working on Chocolate, way less due to my studies, but I'm still here !**\u003cbr\u003e\r\n**I'm currently working on the 7.2.0 version, which will include the docker image, for all the GPU/CPU users.**\u003cbr\u003e\r\n**I have a lot of ideas for the future, I'm looking at how to make a plugin system, and a watchtogether system, and I'm working on an intro detection system.**\u003cbr\u003e\r\n\r\n## About The Project\r\nChocolate is a free and Open Source media manager.\u003cbr\u003e\r\nIt allows you to manage your media collection and organize it in a way that is easy to use and easy to search.\u003cbr\u003e\r\nPair your popcorn with Chocolate and enjoy your favorite movie!\u003cbr\u003e\r\nIt's a free software.\u003cbr\u003e\r\n\r\n\u003cp style=\"display: inline-flex;\r\n    align-items: center;\"\u003e\r\nThis product uses the TMDB API but is not endorsed or certified by TMDB | \u003cimg src=\"https://www.themoviedb.org/assets/2/v4/logos/v2/blue_square_1-5bdc75aaebeb75dc7ae79426ddd9be3b2be1e342510f8202baf6bffa71d7f5c4.svg\" height=\"20px\"\u003e\u003c/p\u003e\u003cbr\u003e\r\n\r\n\u003ca href=\"https://hosted.weblate.org/engage/chocolate/\"\u003e\r\n  \u003cimg src=\"https://hosted.weblate.org/widget/chocolate/translation/multi-auto.svg\"/\u003e\r\n\u003c/a\u003e\r\n\r\n### Built With\r\n\r\nChocolate is actually made with this technologies:\r\n\r\n* \u003cimg src=\"https://ziadoua.github.io/m3-Markdown-Badges/badges/HTML/html1.svg\" alt=\"HTML5\" style=\"display: flex; align-items: center;\"\u003e\r\n* \u003cimg src=\"https://ziadoua.github.io/m3-Markdown-Badges/badges/CSS/css1.svg\" alt=\"CSS3\" style=\"display: flex; align-items: center;\"\u003e\r\n* \u003cimg src=\"https://ziadoua.github.io/m3-Markdown-Badges/badges/Javascript/javascript1.svg\" alt=\"Javascript\" style=\"display: flex; align-items: center;\"\u003e\r\n* \u003cimg src=\"https://ziadoua.github.io/m3-Markdown-Badges/badges/Python/python1.svg\" alt=\"Python\" style=\"display: flex; align-items: center;\"\u003e\r\n* \u003cimg src=\"https://ziadoua.github.io/m3-Markdown-Badges/badges/Flask/flask1.svg\" alt=\"Flask\" style=\"display: flex; align-items: center;\"\u003e\r\n\r\n\r\n\u003c!-- GETTING STARTED --\u003e\r\n## Getting Started\r\n\r\nThis is what you have to do to get started with Chocolate :\r\n\r\n## Prerequisites\r\n\r\n### Installation\r\n\r\n#### For Windows/Linux/Mac\r\n* Make sure you have at least python 3.10 and pip installed\r\n* Execute ```pip install chocolate_app```\r\n* To run chocolate, simply execute ```python -m chocolate_app``` or ```python3 -m chocolate_app```\r\n\r\n#### For QNAP\r\n* Go here: [https://www.myqnap.org/product/chocolate81/](https://www.myqnap.org/product/chocolate81/)\r\n* Enjoy !\r\n\r\n#### For Docker\r\n* WIP (Release soon)\r\n\r\n### Files organizations\r\n\r\n#### For Movies :\r\n* Create a directory\r\n* Put all your movies in (directly the files or in a subfolder)\r\n* Create a new library and select the directory you created with the specific type\r\n* It's done\r\n\r\n#### For Shows :\r\n* Create a directory where you will put all your shows\r\n* Choose between two ways to organize your shows :\r\n  * One directory per show, with directories for each season, and files for each episode\r\n  * All files in one directory, for all shows, with a good name that can be analyzed\r\n* Create a new library and select the directory you created with the specific type\r\n* It's done\r\n\r\n#### For Games :\r\n* Create a directory\r\n* Create a directory for each consoles\r\n* For each directory put games for this console\r\n* Some consoles need a bios, go to /static/bios/\r\n  * Create a directory named by the console\r\n  * Put in the bios file\r\n* It's done\r\n\r\n#### For Books :\r\n* Create a directory\r\n* Put all your books in with the name that you want\r\n* It's done\r\n\r\n### List of supported console :\r\n  * Gameboy\r\n  * Gameboy Color\r\n  * Gameboy Advance\r\n  * Nintendo DS\r\n  * Nintendo 64\r\n  * Nintendo Entertainment System\r\n  * Super Nintendo Entertainment System\r\n  * Sega Master System\r\n  * Sega Mega Drive\r\n  * Sega Saturn\r\n  * Sony Playstation 1 (for .cue and .bin you have to .zip all files) (need a bios)\r\n\r\n### Start Chocolate\r\n\r\n#### For Linux \u0026 Windows\r\n* execute 'python3 -m chocolate_app' in your terminal\r\n\r\n\r\n#### For Docker\r\n/!\\ The docker image has some problems, it's not working for now /!\\\r\n* Execute :\r\n  * CMD : `docker run -d -v %cd%:/chocolate imprevisible/chocolate`\r\n  * Powershell : `docker run -d -v ${PWD}:/chocolate imprevisible/chocolate`\r\n  * Linux : `docker run -d -v $(pwd):/chocolate imprevisible/chocolate`\r\n\r\n### Important Informations\r\n* The port of Chocolate is 8888.\r\n\r\n\u003c!-- USAGE EXAMPLES --\u003e\r\n## Usage\r\n![screencapture-localhost-8500-2022-08-18-18_03_30](https://user-images.githubusercontent.com/69050895/185441919-61db8093-8aa7-49d1-aa58-d04520b9a250.png)\r\n![screencapture-localhost-8500-films-2022-08-18-18_04_53](https://user-images.githubusercontent.com/69050895/185442124-ecf72fe9-344f-4836-b21b-597c4c36c1d0.png)\r\n\r\n\r\n\r\n\u003c!-- CONTRIBUTING --\u003e\r\n## Contributing\r\n\r\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\r\n\r\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\r\nDon't forget to give the project a star! Thanks again!\r\n\r\n1. Fork the Project\r\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\r\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\r\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\r\n5. Open a Pull Request\r\n\r\n\u003c!-- TO-DO --\u003e\r\n## TO-DO for Chocolate Server\r\n- [ ] A docker image **URGENT**\r\n- [X] Allow library fusion (for example, if you have two libraries for movies, you can merge them, so only one library will be displayed)\r\n- [X] Create a plugin system\r\n- [ ] Add the mobile ui of the video player\r\n- [ ] Add a watchtogether system\r\n- [ ] Multiple interface\r\n- [ ] Allow custom css\r\n- [ ] Statistics\r\n- [ ] Custom intro\r\n- [ ] Add a system to search for subtitles (By using OpenSubtitles API [here](https://opensubtitles.stoplight.io/docs/opensubtitles-api/b1eb44d4c8502-open-subtitles-api) ) (with the plugin system)\r\n- [ ] Send issues directly from the website\r\n- [ ] Add watched movies, and series to TRAKT (with the plugin system)\r\n- [ ] Add support to trakt (with the plugin system)\r\n- [X] Use the GPU to encode videos if possible\r\n- [ ] Change season with the buttons\r\n- [X] Add logs\r\n- [ ] Design a UI for the path selection instead of a string\r\n- [ ] Use two pages for books on horizontal screen\r\n- [ ] NFO support\r\n- [ ] Allow support of PosgreSQL/MySQL\r\n\r\n### Work in progress\r\n- [ ] Detect series intro and skip them\r\n- [ ] Dev a mobile/TV app with chromecasting, and download\r\n- [ ] Add all audio tracks\r\n\r\n\u003c!-- CONTACT --\u003e\r\n## Contact\r\n\r\nOfficial Discord Server - [https://discord.gg/qbWdzuPhZ4](https://discord.gg/qbWdzuPhZ4)\u003cbr\u003e\r\nProject Link: [https://github.com/ChocolateApp/Chocolate](https://github.com/ChocolateApp/Chocolate)\u003cbr\u003e\r\nImpre'visible#2576 - [@romeo_chevrier](https://twitter.com/romeo_chevrier) - impr.visible@gmail.com\u003cbr\u003e\r\n\r\n\r\n\u003c!-- ACKNOWLEDGMENTS --\u003e\r\n## Acknowledgments\r\n\r\nIf you like this project, please consider giving me a star ⭐ to support my work and the futures update of this project.\r\n[![stars - Chocolate](https://img.shields.io/github/stars/ChocolateApp/Chocolate?style=social)](https://github.com/ChocolateApp/Chocolate)\r\n\r\nThis tool was made by Impre-visible, some features needed the help of several volunteers, that I thank, you can contact them on this server : [Dev'Area](https://discord.gg/hTmbFePH)\r\n\r\nOriginal website design from [Mart](https://www.figma.com/@Martbrady) on [figma](https://www.figma.com/community/file/970595453636409922)\u003cbr\u003e\r\nA special thanks to Mathias08 who made it possible to release v1 of Chocolate and MONSTA CARDO !! who made the animated logo !\r\n\r\nThe consoles images are in part from [Jude Coram](https://www.judecoram.com/pixel-art-game-consoles/) the rest are made by me.\r\n\r\nThis tool was made with ❤ and ☕ by Impre-visible.\r\n\r\n\u003c!-- LICENSE --\u003e\r\n## License\r\n\r\n\u003cdiv style=\"display: flex; align-items: center;\"\u003e\r\n  \u003cspan\u003eThis work is licensed under a \u003c/span\u003e\r\n  \u003ca href=\"https://www.gnu.org/licenses/gpl-3.0.html\" style=\"margin-left:5px;display: flex; align-items: center;\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/badge/License-GPL%20v3-blue.svg\" alt=\"GNU GENERAL PUBLIC LICENSE\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChocolateApp%2FChocolate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FChocolateApp%2FChocolate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChocolateApp%2FChocolate/lists"}