Biblioteca Chinoppo

How it works

The Chinoppo can play Blu-ray discs that carry a small program and can use the internet (BD-Live). The Biblioteca (“library”) is one of those discs, but it lives as a file on a USB stick. When it opens, it asks a small program you will install on your NAS for the posters. When you pick a movie, that program tells the Chinoppo to play it from your usual folder.

Your movies are never moved or changed. The program only reads them.

What you need

Keep some paper handy; you will write down six things in the first steps:

Steps

The Biblioteca’s own screens and web page are in Spanish. The guide gives each button’s Spanish label with its meaning.

1. Prepare the Chinoppo and note its IP

   On the Chinoppo, with the remote

   • Go to Setup → Network and set BD-Live Network Access to On. Without it, the disc cannot fetch the posters.
   • In the same section, find the network information and write down the IP address (something like 192.168.1.16).
   • Recommended: in your router, “reserve” that IP for the Chinoppo so it never changes. If you don’t know how, carry on; just remember that if it stops working one day, the IP may have changed.

2. Get your TMDb key

   On the PC, in the browser

   1. Create a free account at themoviedb.org and confirm your email.
   2. Open your profile → Settings → API and request a key (personal use). Fill in the form with simple answers.
   3. Copy the API Key (32 letters and numbers) and write it down. Don’t share it.
   4. For discs and more posters (recommended): TMDb gives the posters and each movie’s information; fanart.tv gives more posters to pick from and the discs. Also create a free account at fanart.tv and copy your Personal API Key from your profile. Without it, Artwork Studio shows no discs to pick and the disc doesn’t slide out of the case. Write it down next to the TMDb one.

3. Note your NAS details

   On the Chinoppo and in your NAS admin page

   • NAS IP: the address you use to open its admin page in the browser (for example 192.168.1.17). Write it down.
   • The folder, as the Chinoppo sees it: on the Chinoppo open Network → NFS and choose your NAS. Write down the shared folder shown there, the top-level one, for example /volume1/Plex or /share/Movies. Keep upper and lower case exactly. If your movies are deeper inside (like Plex/Library/Movies), that’s fine: you pick those subfolders later, in step 7.
   • The same folder, as the NAS sees it: almost always the same as above. If unsure, look it up in the NAS file manager. Common examples:

     NAS	Path of a folder called “Plex”
     Synology	/volume1/Plex
     QNAP	/share/Plex
     Unraid	/mnt/user/Plex
     TrueNAS	/mnt/YourPoolName/Plex

   Don’t see your NAS under Network → NFS? You are using SMB/Samba today, and the Biblioteca needs NFS. In your NAS settings, turn on the NFS service and give that folder access for the Chinoppo’s IP (read access is enough). If it asks about “squash”, map all users to admin. If there is an option for “non-privileged ports”, tick it. Then check the Chinoppo again.

4. Install the Docker app on the NAS

   In your NAS admin page

   • Install your NAS’s Docker app from its app store: Container Manager (Synology), Container Station (QNAP), Portainer (Asustor and others). Unraid and TrueNAS have it built in.
   • Inside it, find the option to create an application from a docker-compose file. Depending on the brand it is called Project (Synology), Application (QNAP), Stack (Portainer) or Compose.

5. Download the program and put it on the NAS

   On the PC

   1. Open github.com/ophielsamael/biblioteca-chinoppo-public, click the green Code button, then Download ZIP.
   2. With the NAS file manager, upload the ZIP to a folder for your apps (Synology creates one called docker automatically).
   3. Extract it right there (right-click → Extract → Extract here), without creating another folder first. You get a folder biblioteca-chinoppo-public-main with everything inside, including the compose.yaml file.

6. Create the application with your details

   In the NAS Docker app

   1. Create a new project or stack called biblioteca and point it at the biblioteca-chinoppo-public-main folder. If your app can’t pick a folder, paste the contents of compose.yaml into the editor it shows.
   2. In the compose.yaml text, change only the lines ending in <--, using what you wrote down:

      TMDB_API_KEY: "your TMDb key"
      CHINOPPO_IP: "Chinoppo IP"
      NFS_SERVER: "NAS IP"
      NFS_FOLDER: "volume1/Plex"        ← folder as the Chinoppo sees it, WITHOUT the leading /
      TZ: "Europe/London"               ← your time zone: Europe/Rome, America/New_York…
      ...
      - /volume1/Plex:/media/Plex:ro    ← folder as the NAS sees it; keep :/media/Plex:ro as is
      ...
      FANART_API_KEY: "your fanart.tv key"   ← further down, in the artwork part: for the discs

      Keep the quotes.
   3. Save and start (on Synology: Next until Done). The first time it takes a while: 10 to 30 minutes, depending on your NAS. It builds two programs, and the slow one is Artwork Studio (the build window shows npm ci and npm run build for quite some time). Yellow warnings saying deprecated are normal, not errors. Don't close or cancel; when it says running, continue.

   If you got something wrong: stop the application, fix compose.yaml in your Docker app’s editor and start it again.

7. Choose your folders on the Biblioteca page

   On the PC, in the browser

   1. Open http://NAS-IP:8095 (for example http://192.168.1.17:8095). That page belongs to the program you just installed.
   2. If a yellow warning appears at the top, it tells you which detail is missing or wrong. Fix it as in the box of step 6.
   3. Under Carpetas del menú (menu folders) there are examples (3D, ATMOS, Conciertos, Movies, Series). Remove the ones you don’t have with Quitar (remove).
   4. Add your folders: in the form below click Elegir… (choose), browse to your movie folder and click Usar esta carpeta (use this folder). Pick Películas (movies) or Series, an icon, and Guardar (save). Repeat for each section you want in the menu.
   5. Wait: the first time it fetches posters for your whole collection. With hundreds of movies this can take a while. The Títulos (titles) column keeps growing.

   TV shows: organize them as Show name/Season 01/episode.mkv so they appear by season.

8. Prepare the USB stick

   On the PC

   1. On the same page (:8095), at the top, click Descargar archivos para la USB (download files for the USB). You get Biblioteca-USB.zip, already set up for your NAS and your Chinoppo.
   2. Unzip it and copy its contents to the root of the USB stick (not inside another folder). It must look like this:

      USB/
      ├── Biblioteca.iso
      └── AutoScript/

   3. Eject the stick safely.

   If the IP of the NAS or the Chinoppo ever changes, fix the compose (step 6) and download this ZIP again.

9. Plug in and switch on

   On the Chinoppo

   1. With the Chinoppo off, plug in the USB stick and leave it there for good.
   2. Switch it on. The Biblioteca appears by itself 20 to 40 seconds later.
   3. If you go back to the home menu, the Disc icon opens it again.

   Done. Pick a movie with the arrows and OK. The first movie of each folder takes about 40 seconds to start; the next ones, much less.

   ArrowsMove around the wall

   OKDetails / play

   Red / POP-UPGo back

   ColoursSwitch section

   RETURN, TOP MENU and INFO don’t work inside the Biblioteca: the Chinoppo keeps them for itself.

Updating to a new version

1. On your PC, delete the old ZIP from Downloads and get the new one from GitHub (Code → Download ZIP). Open it and check it has the artwork, biblio, disc… folders.
2. In the Docker app, stop the application and delete it. Your menu folders, artwork and progress are stored separately and are kept.
3. In the NAS file manager, delete the biblioteca-chinoppo-public-main folder, upload the new ZIP straight into your apps folder (not inside another folder) and extract it there.
4. Create the application again as in step 6 and fill in your details on the <-- lines again.

Important: some Docker apps (like Container Manager) keep their own copy of compose.yaml once you edit it on their screen, and don't update it when you upload new files. That's why you delete and recreate the application instead of just restarting it.

The USB stick stays as it is, unless the NAS or Chinoppo IP changes or the new version says so.

If something doesn’t work

The Biblioteca doesn’t open by itself at power-on

Check that Biblioteca.iso and the AutoScript folder are at the root of the stick, and that the Chinoppo has the jailbroken firmware. If an autoscript_ok.txt file shows up on the stick, the start-up script did run.

It says “Activa BD-Live”

Step 1 is missing: Setup → Network → BD-Live Network Access = On.

It says “Sin conexion con el servidor” (no connection to the server)

The NAS is off, the application is stopped in the Docker app, or the NAS IP changed. If it changed, fix the compose and download the USB files again (step 8).

It says “Disco sin servidor” (disc without a server)

The Biblioteca.iso on the stick did not come from the page’s button. Download it from there (step 8).

A movie says “No se pudo reproducir” (could not play)

Almost always the NFS permission (step 3) or the NFS_FOLDER value in step 6. Open http://NAS-IP:8095/log to see what happened.

A movie has the wrong poster

Open http://NAS-IP:8095/match and fix it.

Good to know

The first movie of each folder takes about 40 seconds

The Chinoppo has to “connect” to the folder before playing, and can only have one connected at a time. Within the same folder, the next movies start quickly.

Switching off mid-movie

The Chinoppo’s standby is a real power-off. When you switch it on again, the Biblioteca opens by itself.

One “play” at a time

If you press OK several times in a row, the program ignores the repeats so the Chinoppo doesn’t lock up.

Extra: Artwork Studio (cases, banners and discs)

It installs by itself with the Biblioteca, in the same step 6. Open it at http://NAS-IP:3001, or from the Abrir Artwork Studio link on the :8095 page. There you pick, title by title:

• A poster from TMDb or your own from the PC, with a format banner (e.g. “UHDBD with DV and Atmos”) shown on the wall. It suggests the banner from the format the Biblioteca detected.
• A case: black 4K or blue Blu-ray. With a case, the disc slides out of the box on the movie page.
• A backdrop, logo and disc (discs come from fanart.tv and need the free fanart.tv key in FANART_API_KEY in the compose).
• TV show seasons and metadata (to fix a wrongly matched movie).

Step-by-step Artwork Studio guide, with screenshots: artwork-en.html.

Pick in the tabs, then press Aplicar Cambios (apply changes) to apply everything at once. Check the result in the Vista previa (preview) of the :8095 page without switching the Chinoppo on.

Extra: Dolby Vision in MKV files

Out of the box, the Chinoppo plays Dolby Vision MKVs as plain HDR10. The oppo-dv-mkv patch by fandangos (github.com/fandangos/oppo-dv-mkv) makes the TV or projector receive real Dolby Vision (profiles 5, 7 and 8) and also improves subtitles. It is independent of the Biblioteca.

At your own risk. It changes how the player boots. Read the project’s README first. In the factory menu, never press “Fmt buda” or “Fmt apda”.

1. From the project’s Releases, download the mkv-subtitles zip of the latest version (we used v1.7.1).
2. Use a different FAT32 USB stick (not the Biblioteca one). Copy the zip’s contents to its root.
3. Switch the Chinoppo off, remove the Biblioteca stick, plug the patch stick into the rear USB port and switch on.
4. Wait 30 seconds with the home menu on screen, switch off and remove the stick. On the PC, oppo-dv-mkv-result.txt must say INSTALLED.
5. Put the Biblioteca stick back and switch on.

Set Dolby Vision on the TV or projector to TV-led mode. Note: MKVs from 4K discs that carry the Dolby Vision enhancement as a second video track (as MakeMKV leaves them) play as HDR10. Blu-ray ISOs or BDMV folders always play in Dolby Vision.

Equipment we tested with

Advanced

curl -fsSL https://get.docker.com | sh
# /etc/fstab:  NAS-IP:/volume1/Plex  /mnt/nas/media  nfs  ro,defaults  0 0
sudo mount -a
git clone https://github.com/ophielsamael/biblioteca-chinoppo-public.git
cd biblioteca-chinoppo-public
nano compose.yaml        # your details, and the volume:  /mnt/nas/media:/media/Plex:ro
docker compose up -d --build