Skip to content
yoiberdevPublic

About

Tus doramas como un guion coreano: en qué episodio vas, qué sale esta semana y dónde verlo legal en tu país. Web y Android, sobre TMDB.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Daebon

Daebon (대본) quiere decir «guion» en coreano, y la app se ve como uno. Es una web y una app de Android para seguir doramas: en qué episodio vas de cada uno, qué sale esta semana y en qué plataforma lo puedes ver legalmente en tu país. Funciona con dramas de Corea, China, Japón, Taiwán y Tailandia.

Daebon no tiene episodios. Cada ficha te dice si está en Netflix, Viki, Prime Video u otra plataforma de tu país, con el enlace.

Mi lista: cada dorama como un guion engrapado, con una casilla por episodio La ficha: la tapa del guion con el póster sujeto con un clip El reparto escrito como la lista de personajes de un guion Esta semana: lo que sale cada día, agrupado como en la tele coreana Créditos: lo que viste, en una pantalla negra que sube como los créditos finales

Qué hace

Cada pantalla abre como una escena de guion coreano: «S#1. Mi lista (noche)». La hora del día es la de verdad.

Mi lista separa lo que estás viendo, lo que dejaste para después, lo pausado, lo terminado y lo abandonado. Cada dorama es un guion de cartulina engrapado, con una casilla por episodio: en tinta lo que viste, con resaltador amarillo lo que ya salió y te falta, punteado lo que todavía no sale. El botón «Vi el 8» marca el siguiente y se puede deshacer. Arriba dice cuántos episodios tienes por ver y cuántas horas son. Lo terminado lleva el sello rojo 끝 («fin»).

Esta semana es la programación (편성표). Primero lo tuyo, día por día. Después, todo lo que se emite en el país que elijas, agrupado como lo nombran en Corea: 월화드라마 (lunes y martes), 수목드라마 (miércoles y jueves), 금토, 토일, los diarios y los que salen todos de una vez.

Explorar busca doramas y actores, y muestra los populares, los que están en emisión, los recién estrenados, los mejor valorados y los que se vienen, por país y por tema (romance, histórico, venganza, comedia…).

La ficha de cada dorama es la tapa del guion: cadena, título en español y en el idioma original, episodios, duración, quién la creó y si sigue en emisión. Debajo van las plataformas donde está en tu país, la sinopsis, los episodios para marcar, el reparto escrito como la lista de personajes al principio de un guion (등장인물), el tráiler, un enlace para escuchar el OST y recomendaciones. Si la tienes en tu lista, puedes dejarle una nota al margen, que se ve escrita a lápiz.

Cada actor tiene su página con sus doramas y el personaje que hizo en cada uno.

Créditos pasa tus números como los créditos finales de un episodio, en una pantalla negra que sube despacio: horas vistas, episodios, doramas terminados, el reparto que más se repite en lo que viste, los países y tu maratón más larga. Debajo hay una tira de película con los episodios que marcaste cada día de las últimas doce semanas.

En Android, Daebon te avisa el día que sale un episodio de lo que estás viendo, a la hora que elijas, y al tocar el aviso abre la ficha.

Hecho con

Svelte 5 y TypeScript sobre Vite, y Capacitor 8 para el APK (con sus plugins de avisos locales, archivos y compartir). Los datos salen de TMDB, y las plataformas de cada país, de JustWatch a través de TMDB. Tu lista se guarda solo en el dispositivo.

La clave de TMDB no puede ir dentro de la app, así que hay un servidor propio (servidor/, Node sin dependencias) que la guarda y responde un puñado de rutas fijas con lo que cada pantalla necesita, ya en español.

Archivo Para qué
servidor/index.mjs Habla con TMDB: elige el título y la sinopsis en español, guarda las respuestas un rato y limita los pedidos por IP.
src/lib/api.ts Los pedidos al servidor, con una copia en el dispositivo para verlos sin conexión.
src/lib/lista.svelte.ts Tu lista: marcar episodios, ponerla al día, notas y respaldos.
src/lib/avisos.ts Programar los avisos de estreno en Android.
src/lib/formato.ts Fechas, duraciones, países y la franja de cada dorama (월화, 수목…).
src/lib/estado.svelte.ts Preferencias, navegación con el hash de la dirección y los avisos en pantalla.
src/pantallas/ Mi lista, Esta semana, Explorar, Créditos, la ficha, el actor y Ajustes.
scripts/fuentes.py Recorta las fuentes coreanas al hangul que usa la app (de varios megas a unos 40 KB cada una).
scripts/icono.py Dibuja el ícono de la web y los de Android con la misma fuente de los títulos.

Los títulos van en Noto Serif KR, un myeongjo como el de los guiones impresos; el texto, en Pretendard, y las notas al margen, en Caveat. Tiene modo oscuro («noche de rodaje»), y en pantallas anchas las pestañas pasan al costado, como los separadores de un guion.

Los detalles técnicos están en docs/como-funciona.md.

Arrancar

Hace falta Node 22 o más nuevo y un token de lectura de la API de TMDB (gratis, en themoviedb.org/settings/api). Va en servidor/.env:

cp servidor/.env.example servidor/.env   # y pega el token después de TMDB_TOKEN=
npm install
npm run api   # el servidor, en el puerto 8787
npm run dev   # la app, en el 5181; le pasa /api al servidor

npm run check revisa los tipos con svelte-check.

Compilar el APK

Hace falta además el JDK 21 y el SDK de Android.

npm run build
npx cap sync android
cd android && ./gradlew assembleDebug

El APK queda en android/app/build/outputs/apk/debug/app-debug.apk. Funciona desde Android 7 y le pide los datos a https://doramas.yoiber.dev/api.

Publicar la web

Son dos contenedores. El de la web (Dockerfile) compila con Node y sirve el resultado con nginx: caché larga para /assets/, el HTML siempre revalidado y una política de contenido que solo deja cargar las imágenes de TMDB, las miniaturas de YouTube y su reproductor de tráileres. Ese nginx pasa /api/ al servidor (servidor/Dockerfile), que lee el token de TMDB de un .env. Si además le das una clave de Google Cloud Translation, traduce las sinopsis que TMDB no tiene en español.

Los datos y las imágenes son de TMDB. Este producto usa la API de TMDB, pero TMDB no lo respalda ni lo certifica.

In English

Daebon («script» in Korean) is a tracker for Asian dramas, for the web and Android, built with Svelte 5, TypeScript and Capacitor on top of the TMDB API. It is styled as a Korean drama script: every screen opens like a scene heading, each show in your list is a stapled script cover with one box per episode, and finished shows get a red seal. It keeps your list with per-episode progress, shows the week's airing schedule grouped by Korean TV slot, tells you which legal streaming services carry each show in your country, and schedules Android notifications when a new episode airs. A small dependency-free Node backend keeps the TMDB key out of the app and serves Spanish-first data. The app and docs are in Spanish.

About

Tus doramas como un guion coreano: en qué episodio vas, qué sale esta semana y dónde verlo legal en tu país. Web y Android, sobre TMDB.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages