Sankaku Archive Viewer

A high-performance image and video viewer with proxy functionality for Sankaku Complex archives.

D 10 M 12 Y 2025

📢 Due to upstream changes, the source platform has disabled access to hidden content retrieval. As a result, viewing hidden content is currently no longer possible with this tool. 🙈💀 Because of this limitation, I've decided to make this project public and open source. 🎉🎊 You are free to fork this repository and build upon it without needing to ask for permission. 🍴🏃‍♂️💨 If you manage to improve or upgrade this project, please consider sharing it with other users who might be interested in contributing or benefiting from your work! 🤝🔥👀

Translated by Claude AI 🤖✨

Features

• 🖼️ Image viewer with zoom and pan functionality
• 🎥 Video player with streaming support
• 🔍 Advanced search with tag autocomplete
• 🌓 Dark/Light theme toggle
• 📱 Responsive design
• 🚀 Redis/Dragonfly caching
• 🔒 Proxy all requests for privacy
• 🔗 Social media sharing with rich embeds

Installation

1. Clone the repository

git clone <repository-url>
cd sankaku-viewver

2. Install dependencies

npm install

3. Set up environment variables

cp .env.example .env
# Edit .env with your configuration

4. Run the application

npm start
# or for development with auto-reload
npm run dev

Environment Variables

Server Configuration

• PORT - Server port (default: 3000)

Redis/Dragonfly Configuration

• REDIS_URL - Redis connection URL (default: redis://localhost:6379/0)

Cache TTL Settings (in seconds)

• CACHE_TTL_API_DEFAULT - Default API cache (default: 3600)
• CACHE_TTL_API_POSTS - Posts endpoint cache (default: 1800)
• CACHE_TTL_API_TAGS - Tags endpoint cache (default: 7200)
• CACHE_TTL_MEDIA - Media files cache (default: 86400)
• CACHE_TTL_STATIC - Static files cache (default: 604800)

API Configuration

• SANKAKU_API_BASE_URL - Sankaku API base URL
• SANKAKU_V_DOMAIN - V domain for videos/previews
• SANKAKU_S_DOMAIN - S domain for images
• SANKAKU_IS_DOMAIN - IS domain for images
• SANKAKU_CS_DOMAIN - CS domain for content

Request Configuration

• API_TIMEOUT - API request timeout in ms (default: 30000)
• MEDIA_TIMEOUT - Media request timeout in ms (default: 15000)

Headers

• USER_AGENT - User agent for requests
• REFERER - Referer header for requests
• SERVER_NAME - Server name to return in responses
• SERVER_POWERED_BY - X-Powered-By header value

Usage

1. Gallery View: Browse images and videos with filtering options
2. Image Viewer: Click any image to open in full viewer with zoom
3. Video Player: Click any video for streaming playback
4. Search: Use tag autocomplete to find specific content
5. Share: Use share buttons for social media with rich embeds
6. Control Panel: Access /control for cache management and server monitoring

API Endpoints

• / - Main gallery page
• /image?id=<base64> - Image viewer page
• /video?id=<base64> - Video player page
• /api/* - Proxied API requests
• /media/* - Proxied media files
• /cache-stats - Cache statistics
• /control - Control panel with cache management

Development

# Install dev dependencies
npm install --save-dev nodemon

# Run in development mode
npm run dev

License

IDGAF LICENSE

Copyright? What copyright?

Take this code. I don't care what you do with it.

• Sell it? Sure.
• Claim you wrote it? Go ahead.
• Use it to take over the world? Good luck.

I'm not responsible for anything. We never met. This code fell from the sky. ☁️

¯_(ツ)_/¯