Skip to main content

No project description provided

Project description

wakatime PyPI version GitHub release GitHub stars GitHub watchers License issues - Chocolate

Thanks everyone for the support, I'm still working on Chocolate, way less due to my studies, but I'm still here !
I'm currently working on the 7.2.0 version, which will include the docker image, for all the GPU/CPU users.
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.

About The Project

Chocolate is a free and 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 |


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 Windows/Linux/Mac

  • Make sure you have at least python 3.10 and pip installed
  • Execute pip install chocolate_app
  • To run chocolate, simply execute python -m chocolate_app or python3 -m chocolate_app

For QNAP

For Docker

  • WIP (Release soon)

Files organizations

For Movies :

  • Create a directory
  • Put all your movies in (directly the files or in a subfolder)
  • Create a new library and select the directory you created with the specific type
  • It's done

For Shows :

  • Create a directory where you will put all your shows
  • Choose between two ways to organize your shows :
    • One directory per show, with directories for each season, and files for each episode
    • All files in one directory, for all shows, with a good name that can be analyzed
  • 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 & Windows

  • execute 'python3 -m chocolate_app' in your terminal

For Docker

/!\ The docker image has some problems, it's not working for now /!\

  • 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

  • The port of Chocolate is 8888.

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
  • Allow library fusion (for example, if you have two libraries for movies, you can merge them, so only one library will be displayed)
  • Create a plugin system
  • Add the mobile ui of the video player
  • Add a watchtogether system
  • Multiple interface
  • Allow custom css
  • Statistics
  • Custom intro
  • Add a system to search for subtitles (By using OpenSubtitles API here ) (with the plugin system)
  • Send issues directly from the website
  • Add watched movies, and series to TRAKT (with the plugin system)
  • Add support to trakt (with the plugin system)
  • Use the GPU to encode videos if possible
  • Change season with the buttons
  • Add logs
  • Design a UI for the path selection instead of a string
  • Use two pages for books on horizontal screen
  • NFO support
  • Allow support of PosgreSQL/MySQL

Work in progress

  • Detect series intro and skip them
  • Dev a mobile/TV app with chromecasting, and download
  • Add all audio tracks

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 GNU GENERAL PUBLIC LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chocolate_app-10.0.5a0.tar.gz (4.5 MB view details)

Uploaded Source

Built Distribution

chocolate_app-10.0.5a0-py3-none-any.whl (5.4 MB view details)

Uploaded Python 3

File details

Details for the file chocolate_app-10.0.5a0.tar.gz.

File metadata

  • Download URL: chocolate_app-10.0.5a0.tar.gz
  • Upload date:
  • Size: 4.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.18.1 CPython/3.10.12 Linux/6.8.0-48-generic

File hashes

Hashes for chocolate_app-10.0.5a0.tar.gz
Algorithm Hash digest
SHA256 31ed743062add86f4bc74bc69ff2dd8d81a638b014caf53c5d75edd3aa4d145d
MD5 6f9b930f42e7f5f483ef8edce9a68ddc
BLAKE2b-256 f06b80c158301066df6ada591663b64309981902e1b0864554a04adb70d720aa

See more details on using hashes here.

File details

Details for the file chocolate_app-10.0.5a0-py3-none-any.whl.

File metadata

  • Download URL: chocolate_app-10.0.5a0-py3-none-any.whl
  • Upload date:
  • Size: 5.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.18.1 CPython/3.10.12 Linux/6.8.0-48-generic

File hashes

Hashes for chocolate_app-10.0.5a0-py3-none-any.whl
Algorithm Hash digest
SHA256 35d64a64bbff36e523141ac2659d72fcc120f4649c4c6361707d645a84b5bc37
MD5 4767c58fc7c011a7153d4230d3f067ac
BLAKE2b-256 9caa14b017c6992f5d5066ff545b333a6fcb71e7f7cb65bc3d71834f34606c54

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page