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-9.1.0.tar.gz (6.1 MB view details)

Uploaded Source

Built Distribution

chocolate_app-9.1.0-py3-none-any.whl (7.0 MB view details)

Uploaded Python 3

File details

Details for the file chocolate_app-9.1.0.tar.gz.

File metadata

  • Download URL: chocolate_app-9.1.0.tar.gz
  • Upload date:
  • Size: 6.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.15.1 CPython/3.10.12 Linux/6.5.0-44-generic

File hashes

Hashes for chocolate_app-9.1.0.tar.gz
Algorithm Hash digest
SHA256 cd2388ec0ebcb5cd8b6d461458a33052c4c86741760d7a55bd02c75736ec766a
MD5 7cd980a6217e679415ecadac9c3cd403
BLAKE2b-256 ca6893c6d1499fee609590ba9499a97c5dc322398751ac6ddf3b463cc51b169c

See more details on using hashes here.

File details

Details for the file chocolate_app-9.1.0-py3-none-any.whl.

File metadata

  • Download URL: chocolate_app-9.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.15.1 CPython/3.10.12 Linux/6.5.0-44-generic

File hashes

Hashes for chocolate_app-9.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fb574225c8cf80c6cd8511fd2e85b453b0476e96360857b0a08a42b15fe6712c
MD5 6f97dc8bddb9d7e568d28325e9345418
BLAKE2b-256 a74f66ce95821ac6fe4d925cc70830b7a39a7a190769e890aeffe3a28cde9910

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