0 Fork 0

Files

T

MasutaYunikon c0fb601ef0 feat(organize): scan initial mediaPath + logs fichier centralisés

- organize: scanMediaPath au démarrage — détecte les fichiers déjà présents dans Jellyfin
- organize: index filename → infohash pour le matching sans qBittorrent
- logger: remplacement des console.log/warn/error par logger dans organize.ts et index.ts
- logger: logs worker passés via logger[level] au lieu de console direct
- fix: worker déjà en cours loggé en debug au lieu de info

2026-03-11 15:09:06 +01:00

6.0 KiB

Raw Blame History

Fankarr

Gestionnaire de téléchargements pour le catalogue Fankai
Inspiré de Radarr/Sonarr — interface dédiée aux éditions Kai & Yabai

Vue catalogue : toutes les séries Fankai avec leur état d'organisation. Les badges indiquent si les fichiers sont déjà présents dans votre médiathèque Jellyfin.

Fonctionnalités

Catalogue complet des séries Fankai avec affiches, statut et badges d'état
Téléchargement en un clic vers qBittorrent — par épisode, par saison ou intégrale
Organisation automatique des fichiers téléchargés vers votre médiathèque (hardlink ou déplacement)
Suivi par épisode — badge ✓ organisé sur chaque épisode et compteur par saison
Notifications toast automatiques quand une organisation se termine
Page téléchargements avec statut d'organisation et badge erreurs avec détail au hover
Logs centralisés avec filtre par niveau/source, rotation automatique et clear depuis l'UI
Multi-client torrent — architecture extensible (qBittorrent supporté)
Authentification par mot de passe avec session JWT
Compatible Runtipi / Docker

Vue série : détail des épisodes avec leur état de disponibilité torrent et d'organisation dans Jellyfin.

Vue téléchargements : suivi en temps réel de l'organisation avec détail des erreurs au survol.

Page logs : historique complet des événements avec filtres et gestion de la taille.

Données torrent — Scraper

Les données du catalogue sont récupérées depuis le repo fankarr-scraper.

Ce repo contient un pipeline de scripts Python qui collecte, parse et résout les torrents Fankai depuis les trackers publics, puis les croise avec l'API metadata de Fankai pour identifier chaque épisode. Les scripts tournent automatiquement toutes les 6 heures via GitHub Actions et publient le fichier torrent_final.json dans le repo.

Fankarr récupère ce fichier au démarrage et via le bouton Mettre à jour dans les paramètres. Aucun scraping ne se fait en local.

Installation

Prérequis

Docker + Docker Compose
qBittorrent accessible en réseau
Un dossier de téléchargements complétés (/downloads/complete ou équivalent)
Un dossier médiathèque pour Jellyfin (/media/Kai ou équivalent)

Docker Compose

services:
  fankarr:
    image: masutayunikon/fankarr:latest
    container_name: fankarr
    environment:
      - PUID=1000        # UID de votre utilisateur (id -u)
      - PGID=1000        # GID de votre utilisateur (id -g)
      - TZ=Europe/Paris  # Votre timezone
    volumes:
      - ./data:/app/data                        # Config, logs, base de données
      - /votre/chemin/media:/media/Kai          # Destination Jellyfin
      - /votre/chemin/complete:/downloads/complete  # Dossier complétés qBittorrent
    ports:
      - 3001:3001
    restart: unless-stopped

docker compose up -d

Fankarr sera accessible sur http://localhost:3001.

Variables d'environnement

Variable	Défaut	Description
`PUID`	`1000`	UID utilisateur pour les permissions fichiers
`PGID`	`1000`	GID utilisateur pour les permissions fichiers
`TZ`	—	Timezone (ex: `Europe/Paris`)
`GITHUB_RAW_URL`	repo scraper	URL du `torrent_final.json` à utiliser

Premier démarrage

Ouvrir http://localhost:3001
Créer un mot de passe à la première connexion
Aller dans Paramètres → ajouter votre client qBittorrent
Vérifier les chemins completePath et mediaPath
Choisir le mode d'organisation : hardlink (recommandé) ou move
Retourner au catalogue et télécharger

Organisation des fichiers

Fankarr organise automatiquement les fichiers terminés toutes les 30 secondes vers la structure attendue par Jellyfin :

/media/Kai/
└── Black Lagoon Henshū/
    └── Saison 001/
        ├── Black Lagoon Henshū S01E01.mkv
        ├── Black Lagoon Henshū S01E02.mkv
        └── ...

Le mode hardlink est recommandé si vos dossiers complete et media sont sur le même filesystem — les fichiers ne sont pas déplacés, qBittorrent continue de seeder.

Runtipi

Fankarr est disponible dans l'appstore personnalisé. Pour l'installer :

Dans Runtipi, aller dans Paramètres → App Stores
Ajouter l'URL : https://github.com/Masutayunikon/runtipi-appstore
Fankarr apparaît dans le catalogue → Installer

Stack technique

Couche	Technologie
Frontend	Vue 3 + Vite + Tailwind CSS
Backend	Express 5 + TypeScript
Auth	JWT + bcrypt
Packaging	Docker (`node:20-slim`) + pnpm
Permissions	gosu (PUID/PGID)

Liens

fankai.fr — Le projet Fankai
Plugin Jellyfin Fankai — Reconnaissance des métadonnées dans Jellyfin
fankarr-scraper — Pipeline de collecte des torrents

6.0 KiB Raw Blame History