Javinizer Go

Javinizer Go is a metadata scraper and file organizer for Japanese Adult Videos (JAV), with CLI, TUI, API, and a web UI.

Features

Supported Scrapers

Installation

Docker (Recommended)

The easiest way to get started is with Docker:

# 1) Create data directory and download config
mkdir -p ./javinizer-data
curl -o ./javinizer-data/config.yaml \
  https://raw.githubusercontent.com/javinizer/javinizer-go/main/configs/config.yaml.example

# 2) Edit config.yaml with your settings (scrapers, output paths, etc.)

# 3) Run container
docker run --rm \
  -p 8080:8080 \
  -v "$(pwd)/javinizer-data:/javinizer" \
  -v "/path/to/your/media:/media" \
  ghcr.io/javinizer/javinizer-go:latest

Open http://localhost:8080 to access the web UI.

Notes:

• Replace /path/to/your/media with the path to your JAV library
• Use a pinned tag (e.g., v0.1.2-alpha) for reproducible deployments
• latest tracks the most recent release

Docker Compose

For a more complete setup with optional FlareSolverr support:

# 1) Download example files
curl -o docker-compose.yml \
  https://raw.githubusercontent.com/javinizer/javinizer-go/main/docker-compose.yml.example
curl -o .env \
  https://raw.githubusercontent.com/javinizer/javinizer-go/main/.env.example

# 2) Edit .env to configure paths and settings
# MEDIA_PATH=/path/to/your/jav-library
# TZ=America/New_York

# 3) Start services
docker-compose up -d

The docker-compose.yml.example includes:

• javinizer: Main API server + web UI
• flaresolverr (optional): Cloudflare challenge solver for JavDB/JavLibrary

See Docker Deployment Guide for complete documentation.

Prebuilt Binaries

Download pre-compiled binaries from GitHub Releases:

Available platforms:

• linux-amd64 - Linux x86_64
• linux-arm64 - Linux ARM64 (e.g., Raspberry Pi)
• darwin-amd64 - macOS Intel
• darwin-arm64 - macOS Apple Silicon
• darwin-universal - macOS Universal (Intel + Apple Silicon)
• windows-amd64 - Windows x86_64

Installation:

# Example for Linux amd64
wget https://github.com/javinizer/javinizer-go/releases/download/v0.1.2-alpha/javinizer-linux-amd64.tar.gz
tar -xzf javinizer-linux-amd64.tar.gz
sudo mv javinizer /usr/local/bin/
javinizer version

Note: Prebuilt binaries include CLI, TUI, API server, and embedded web UI.

Build from Source

Requires Go 1.25+ and CGO (for SQLite support). For embedded web UI builds, Node.js 20+ is also required.

go install github.com/javinizer/javinizer-go/cmd/javinizer@latest

# Or clone and build manually (single binary with embedded web UI)
git clone https://github.com/javinizer/javinizer-go.git
cd javinizer-go
make build
./bin/javinizer version

The make build target now builds the frontend bundle and embeds it into the Go binary.

Usage

Interactive TUI (Terminal UI)

Browse and scrape files interactively with real-time progress:

javinizer tui ~/Videos

See TUI Guide for keyboard shortcuts and workflows.

File Organization

Scan, scrape metadata, and organize files using templates:

# Dry-run mode (preview changes without modifying files)
javinizer sort ~/Videos --dry-run

# Actually organize files
javinizer sort ~/Videos

Manual Scraping

Scrape metadata for a specific JAV ID:

javinizer scrape IPX-535
javinizer scrape SSIS-123 --force  # Force refresh cached metadata

Update Existing Metadata

Re-scrape and update metadata for already organized files:

javinizer update ~/Videos/IPX-535
javinizer update ~/Videos --dry-run  # Preview updates for entire library

Manage Tags

Add custom tags to movies (appears in NFO files):

javinizer tag add IPX-535 "favorite" "4K"
javinizer tag list IPX-535
javinizer tag remove IPX-535 "favorite"

Genre Management

View and modify genre replacement rules:

javinizer genre list
javinizer genre add "Creampie" "Cream Pie"  # Replace "Creampie" with "Cream Pie"
javinizer genre remove "Creampie"

History Tracking

View and rollback file organization operations:

javinizer history list
javinizer history rollback <operation-id>

System Info

Display configuration, scrapers, and database status:

javinizer info
javinizer info --scrapers  # List enabled scrapers
javinizer info --config    # Show current configuration

API + Web Server (web Alias)

Start the unified server (recommended via web alias):

javinizer web

# Equivalent legacy command
javinizer api

# Custom port
PORT=9000 javinizer web

# With flags
javinizer web --host 0.0.0.0 --port 8081

javinizer api and javinizer web invoke the same backend server command, but they represent different usage intents:

• Use javinizer api for backend/API-focused workflows and frontend development (npm run dev hot reload).
• Use javinizer web when you want the embedded browser UI entrypoint from the Go binary.

What this server provides:

• GET / - Embedded Web UI (single-binary distribution)
• GET /api/v1/... - REST API endpoints
• GET /ws/progress - WebSocket progress stream
• GET /docs - Scalar API docs UI
• GET /swagger/index.html - Swagger UI

Web UI

The web application provides a modern interface for managing your JAV library.

Availability:

• ✅ Docker: Web UI is included and available at localhost:8080
• ✅ CLI/Binary: Web UI is embedded in the binary and served at localhost:8080

How to access:

# Using Docker (recommended)
docker run -p 8080:8080 -v ./data:/javinizer ghcr.io/javinizer/javinizer-go:latest
# Open http://localhost:8080

Pages:

• Dashboard - Quick stats and recent activity
• Browse - View organized movies with covers and metadata
• Review - Batch scrape files, crop posters, edit metadata before organizing
• Actresses - Browse actress database with images
• History - View and rollback organization operations
• Settings - Configure scrapers, output templates, and proxy settings

API Documentation:

• Scalar UI: http://localhost:8080/docs - Interactive API documentation
• Swagger UI: http://localhost:8080/swagger/index.html - OpenAPI spec viewer

See API Reference for endpoint documentation.

Web Development

To build and use the web UI with a local installation:

Option 1: Production build (single binary with embedded UI)

# Build binary (includes web bundle)
make build

# Start API/web server
javinizer web
# Open http://localhost:8080

Option 2: Development mode (hot reload)

# Terminal 1: Start backend API server
javinizer api

# Terminal 2: Start frontend dev server with hot reload
make web-dev
# Open http://localhost:5174 (proxies API calls to :8080)

The development server provides:

• Hot module replacement (instant updates on file changes)
• Better error messages
• Faster iteration

See web/frontend/README.md for more details.

Environment Variables

Docker deployments support environment variable overrides:

Example:

docker run --rm \
  -e LOG_LEVEL=debug \
  -e TZ=Asia/Tokyo \
  -p 9000:8080 \
  -v "$(pwd)/data:/javinizer" \
  -v "/media/jav:/media" \
  ghcr.io/javinizer/javinizer-go:latest

See .env.example for Docker Compose configuration.

Configuration

Javinizer uses a YAML configuration file to control scrapers, output templates, and behavior.

Key configuration sections:

• Scrapers: Enable/disable sources, set priorities, configure proxies
• Metadata: Field-level scraper priorities, translation, genre filtering
• Output: Folder/file naming templates, download options
• File Matching: Extensions, size filters, regex patterns
• NFO: Kodi/Plex metadata format options

Documentation:

• Configuration Guide - Detailed option reference
• Example Config - Fully commented configuration
• Template System - Output template syntax and functions
• Genre Management - Genre replacement workflow

Initialize config:

javinizer init  # Creates default config.yaml in current directory

Documentation

• Getting Started - Installation and first steps
• Docker Deployment - Container setup and management
• Configuration - Config file reference
• CLI Reference - Command-line interface guide
• TUI Guide - Interactive terminal UI
• API Reference - REST API endpoints
• Template System - Output naming templates
• Genre Management - Genre replacement rules
• Troubleshooting - Common issues and solutions

Support

• Issues: github.com/javinizer/javinizer-go/issues
• Discussions: github.com/javinizer/javinizer-go/discussions

License

This project is a Go recreation of the original Javinizer.

MIT License - see LICENSE file for details.