https://github.com/ChocolateApp/Chocolate Skip to content Toggle navigation Sign up * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Case Studies + Customer Stories + Resources * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing [ ] * # In this repository All GitHub | Jump to | * No suggested jump to results * # In this repository All GitHub | Jump to | * # In this organization All GitHub | Jump to | * # In this repository All GitHub | Jump to | Sign in Sign up {{ message }} ChocolateApp / Chocolate Public * Notifications * Fork 4 * Star 118 The future of media manager chocolateapp.github.io/ License View license 118 stars 4 forks Star Notifications * Code * Issues 4 * Pull requests 2 * Actions * Projects 0 * Security * Insights More * Code * Issues * Pull requests * Actions * Projects * Security * Insights ChocolateApp/Chocolate This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. main Switch branches/tags [ ] Branches Tags Could not load branches Nothing to show {{ refName }} default View all branches Could not load tags Nothing to show {{ refName }} default View all tags Name already in use A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch? Cancel Create 1 branch 16 tags Code * Local * Codespaces * Clone HTTPS GitHub CLI [https://github.com/C] Use Git or checkout with SVN using the web URL. [gh repo clone Chocol] Work fast with our official CLI. Learn more. * Open with GitHub Desktop * Download ZIP Sign In Required Please sign in to use Codespaces. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching Xcode If nothing happens, download Xcode and try again. Launching Visual Studio Code Your codespace will open once ready. There was a problem preparing your codespace, please try again. Latest commit @Impre-visible Impre-visible Update README.md ... 9d84946 Feb 24, 2023 Update README.md 9d84946 Git stats * 186 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time static templates .gitignore Dockerfile README.md app.py config.ini convert.py docker-compose.yml intro.py licence.md requirements.txt View code [ ] About The Project Built With Getting Started Prerequisites Installation For Linux For Windows For QNAP For Docker Files organizations For Movies : For Shows : For Games : For Books : List of supported console : Start Chocolate For Linux For Windows For Docker Important Informations Usage Contributing TO-DO for Chocolate Server Work in progress Tasks Done Languages to translate Contact Acknowledgments License README.md [185436929-c80736b3-07ce-434b-ba96-d753c8e9f83c] wakatime GitHub release GitHub stars GitHub watchers License issues - Chocolate About The Project Chocolate is an Open Source media manager. It allows you to manage your media collection and organize it in a way that is easy to use and easy to search. Pair your popcorn with Chocolate and enjoy your favorite movie! It's a free software. This product uses the TMDB API but is not endorsed or certified by TMDB | [6874747073] Built With Chocolate is actually made with this technologies: * HTML5 * CSS3 * Javascript * Python * Flask Getting Started This is what you have to do to get started with Chocolate : Prerequisites Installation For Linux * Go to the latest release * Download the latest installer named install.sh * Place it where you want * Run it * Enjoy ! For Windows * No installer available actually * So download the source code and install the dependencies (requirements.txt, ffmpeg and winrar (only for cbr files so books)) * For ffmpeg and winrar, you have to add them to your PATH For QNAP * Go here: https://www.myqnap.org/product/chocolate81/ * Enjoy ! For Docker * Execute docker pull imprevisible/chocolate * Enjoy ! Files organizations For Movies : * Create a directory * Put all your movies in with a proper name, like "Batman Begins.mkv" instead of "Batman.Begins.H264.AAC.XxMOVIESxX.mkv", they can be in subdirectories (only one level, one movie per directory) Movies +-- Batman Begins # Perfect | +-- Batman Begins.mkv +-- Back to the Future.mkv +-- Harry Potter and the Philosopher's Stone.mkv | +-- The Lord of the Rings # Don't do that please (two movies in one directory !) | +-- The Lord of the Rings - The Fellowship of the Ring.mkv | +-- The Lord of the Rings - The Two Towers.mkv * Create a new library and select the directory you created with the specific type * It's done For Shows : * Create a directory * Create a directory for each shows * In this directory create directory for each seasons, if possible named them like that : "S1", "S2", "S26" * In this seasons directory put all episodes files, and if possible named them like that : "E1.mkv", "E2.mp4", "E56.avi" * Precisions : Chocolate will ask you to rename files and directory if it don't understand, you can agree or disagree is proposition Shows +-- The Office # Perfect | +-- S1 | | +-- E1.mkv | | +-- E2.mkv | | +-- E3.mkv | | | +-- S2 | +-- E1.mkv | +-- The Simpsons # Don't do that please | +-- Season 1 | +-- The.Simpsons.EP.One.mkv | +-- The.Simpsons.EP.Two.mkv | +-- The.Simpsons.EP.Three.mkv * Create a new library and select the directory you created with the specific type * It's done For Games : * Create a directory * Create a directory for each consoles * For each directory put games for this console * Some consoles need a bios, go to /static/bios/ + Create a directory named by the console + Put in the bios file * It's done For Books : * Create a directory * Put all your books in with the name that you want * It's done List of supported console : * Gameboy * Gameboy Color * Gameboy Advance * Nintendo DS * Nintendo 64 * Nintendo Entertainment System * Super Nintendo Entertainment System * Sega Master System * Sega Mega Drive * Sega Saturn * Sony Playstation 1 (for .cue and .bin you have to .zip all files) (need a bios) Start Chocolate For Linux * execute 'chocolate' in your terminal For Windows * Execute app.py For Docker * Execute : + CMD : docker run -d -v %cd%:/chocolate imprevisible/chocolate + Powershell : docker run -d -v ${PWD}:/chocolate imprevisible/ chocolate + Linux : docker run -d -v $(pwd):/chocolate imprevisible/ chocolate Important Informations * At the first launch, Chocolate will be very fast if you don't renseign the path in config.ini. * If you don't change all the paths. Go to the settings, and fill in the forms. * You can change a lot of settings directly on the website. * The default port is 8500. Usage screencapture-localhost-8500-2022-08-18-18_03_30 screencapture-localhost-8500-films-2022-08-18-18_04_53 Contributing Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. If 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". Don't forget to give the project a star! Thanks again! 1. Fork the Project 2. Create your Feature Branch (git checkout -b feature/ AmazingFeature) 3. Commit your Changes (git commit -m 'Add some AmazingFeature') 4. Push to the Branch (git push origin feature/AmazingFeature) 5. Open a Pull Request TO-DO for Chocolate Server * [ ] A docker image URGENT * [ ] Create a plugin system * [ ] Add the mobile ui of the video player * [ ] Add Books, PDF, Epub * [ ] Add Musics * [ ] Add a watchtogether system * [ ] Translate in multiple languages * [ ] Multiple interface * [ ] Allow custom css * [ ] Statistics * [ ] Custom intro * [ ] Add a system to search for subtitles (By using OpenSubtitles API here ) * [ ] Send issues directly from the website * [ ] Order by title, year, release date, note, duration, done, watching, date of add, date of last view * [ ] Add watched movies, and series to TRAKT * [ ] Add movies, series, games without restarting the server * [ ] Add support to trakt * [ ] Use the GPU to encode videos if possible * [ ] Change season with the buttons * [ ] Add logs * [ ] Use arrow keys to change books pages * [ ] Design a UI for the path selection instead of a string * [ ] Use two pages for books on horizontal screen Work in progress * [ ] Detect series intro and skip them * [ ] Dev a mobile/TV app with chromecasting, and download * [ ] Use Flask-PWA * [ ] Add all audio tracks * [ ] Translate the rescan buttons * [ ] Add website UI to link with Radarr, Sonarr, Lidarr... (with pyarr/aiopyarr) * [ ] Move the UI to React Tasks Done * [*] Increase the boot speed * [*] Added the Consoles on the main page * [*] Replace JSON by a DB * [*] Converted all images to webp * [*] Create a local account system for child and members of the family/friends * [*] Patch few bugs like : + [*] Actors page + [*] Popup of the first and random show * [*] Add Games * [*] Add shows, tv programs * [*] Enable or not RPC for Discord * [*] Add multiple quality videos * [*] Vue systeme by account instead of computer * [*] Add the loading everywhere * [*] Repair the RPC System (added a button for the github) * [*] Create a systeme of library * [*] Increase the search system * [*] Upgrade the responsive * [*] Edit movie metadata directly on the website * [*] Add a download button * [*] Add TV with M3U playlist * [*] Added new type of library, "other", for files that are not movies, series, games, tv * [*] Add 2 buttons, one rescan the library, and the other one in the settings to rescan all the libraries * [*] Scan movies in subdirectory * [*] Edit libraries * [*] Added books (epub, pdf, cbz, cbr) * [*] Edit TV Shows * [*] Increased the search algorithms Languages to translate * [*] AF: Afrikaans * [*] SQ: Albanian * [*] AM: Amharic * [*] AR: Arabic * [*] HY: Armenian * [*] AZ: Azerbaijani * [*] EU: Basque * [*] BE: Belarusian * [*] BN: Bengali * [*] BS: Bosnian * [*] BG: Bulgarian * [*] CA: Catalan * [*] NY: Chichewa * [*] CO: Corsican * [*] HR: Croatian * [*] CS: Czech * [*] DA: Danish * [*] NL: Dutch * [*] EN: English * [*] EO: Esperanto * [*] ET: Estonian * [*] FI: Finnish * [*] FR: French * [ ] FY: Frisian * [ ] GL: Galician * [ ] KA: Georgian * [*] DE: German * [ ] EL: Greek * [ ] GU: Gujarati * [ ] HT: Haitian Creole * [ ] HA: Hausa * [ ] HE: Hebrew * [ ] HI: Hindi * [ ] HU: Hungarian * [ ] IS: Icelandic * [ ] IG: Igbo * [ ] ID: Indonesian * [ ] GA: Irish * [*] IT: Italian * [ ] JA: Japanese * [ ] JV: Javanese * [ ] KN: Kannada * [ ] KK: Kazakh * [ ] KM: Khmer * [ ] KO: Korean * [ ] KU: Kurdish (Kurmanji) * [ ] LO: Lao * [ ] LA: Latin * [ ] LV: Latvian * [ ] LT: Lithuanian * [ ] LB: Luxembourgish * [ ] MK: Macedonian * [ ] MG: Malagasy * [ ] MS: Malay * [ ] ML: Malayalam * [ ] MT: Maltese * [*] ZH: Mandarin * [ ] MI: Maori * [ ] MR: Marathi * [ ] MN: Mongolian * [ ] NE: Nepali * [ ] NO: Norwegian * [ ] PS: Pashto * [ ] FA: Persian * [ ] PL: Polish * [ ] PT: Portuguese * [ ] PA: Punjabi * [ ] RO: Romanian * [ ] RU: Russian * [ ] SM: Samoan * [ ] GD: Scots Gaelic * [ ] SR: Serbian * [ ] SN: Shona * [ ] SD: Sindhi * [ ] SK: Slovak * [ ] SL: Slovenian * [ ] SO: Somali * [*] ES: Spanish * [ ] SU: Sundanese * [ ] SW: Swahili * [ ] SV: Swedish * [ ] TG: Tajik * [ ] TA: Tamil * [ ] TT: Tatar * [ ] TE: Telugu * [ ] TH: Thai * [ ] TR: Turkish * [ ] TK: Turkmen * [ ] UK: Ukrainian * [ ] UR: Urdu * [ ] UZ: Uzbek * [ ] VI: Vietnamese * [ ] CY: Welsh * [ ] XH: Xhosa * [ ] YI: Yiddish * [ ] YO: Yoruba * [ ] ZU: Zuluv Contact Official Discord Server - https://discord.gg/qbWdzuPhZ4 Project Link: https://github.com/ChocolateApp/Chocolate Impre'visible#2576 - @romeo_chevrier - impr.visible@gmail.com Acknowledgments If you like this project, please consider giving me a star to support my work and the futures update of this project. stars - Chocolate This 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 Original website design from Mart on figma A special thanks to Mathias08 who made it possible to release v1 of Chocolate and MONSTA CARDO !! who made the animated logo ! The consoles images are in part from Jude Coram the rest are made by me. This tool was made with and [?] by Impre-visible. License This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License About The future of media manager chocolateapp.github.io/ Topics encoding app movies ffmpeg anime video-player manager plex media tmdb media-server show mediamanager chocolate jellyfin chocolateapp local-media-server Resources Readme License View license Stars 118 stars Watchers 8 watching Forks 4 forks Report repository Releases 14 v5.6.0 Latest Feb 7, 2023 + 13 releases Packages 0 No packages published Languages * Python 40.6% * JavaScript 37.5% * CSS 13.2% * HTML 8.6% * Dockerfile 0.1% Footer (c) 2023 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.