https://github.com/viktor02/hydrus-viewer

Hydrus Viewer in Flask
https://github.com/viktor02/hydrus-viewer

hydrus hydrus-network hydrusnetwork

Last synced: 4 months ago
JSON representation

Hydrus Viewer in Flask

• Host: GitHub
• URL: https://github.com/viktor02/hydrus-viewer
• Owner: viktor02
• License: mit
• Created: 2023-01-15T02:39:53.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2025-11-05T00:42:09.000Z (7 months ago)
• Last Synced: 2025-11-05T01:16:15.320Z (7 months ago)
• Topics: hydrus, hydrus-network, hydrusnetwork
• Language: HTML
• Homepage:
• Size: 175 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Hydrus Viewer

## Why

When I started this project, it seemed to me that there were no good and simple solutions for the hydrus web gallery. Those that were, took time to set up and I didn't like them. So I decided to write my own gallery.

## Features

1. Search the gallery by tags

2. View images 

3. Import URLs to hydrus

4. Optimized for PC and mobile

5. Simply to install and set up (Now with docker!).

## How to install

### Build from sources:

1. Clone the repository 

   `git clone https://github.com/viktor02/hydrus-viewer`

2. cd to cloned directory 

   `cd hydrus-viewer`

3. Install from source 

    `pip install .`

4. Run

    `hydrus_viewer `

5. App will start at 127.0.0.1:8020 (you can change IP and Port with --bind and --port args)

### Docker

1. Clone git repo

   `git clone https://github.com/viktor02/hydrus-viewer`

2. Build with docker:

   `docker build -t hydrus_viewer ./hydrus_viewer`

3. Start containers

Using docker-compose:

```yaml

version: '3.8'

services:

  hydrusclient:

    image: ghcr.io/hydrusnetwork/hydrus:latest

    container_name: hydrusclient

    restart: unless-stopped

    environment:

      - UID=1000

      - GID=1000

    volumes:

      - ./db:/opt/hydrus/db

    tmpfs:

      - /tmp #optional for SPEEEEEEEEEEEEEEEEEEEEEEEEED and less disk access

    ports:

      - 5800:5800   #noVNC

      - 5900:5900   #VNC

      - 45868:45868 #Booru

      - 45869:45869 #API

  hydrus_viewer:

    image: hydrus_viewer

    container_name: hydrus_viewer

    restart: unless-stopped

    environment:

      - TOKEN=secrettokenforapi

      - API_URL=http://hydrusclient:45869/

      - BIND=0.0.0.0

      - PORT=80

    ports:

      - 80:80

```

## How it looks

![MainPage](img/main_page.png)

![SearchPage](img/search_page.png)