Welcome Distribution Configuration First start Concepts Triage Links Credits Return To Top

Welcome

zobtube is an adult video viewer and management tool.

It serves videos over a nice web UI delivered by a web.

It allows setting actors for given videos.

Actors can have profile pictures retrieved from major public platforms.

You can then search your videos by actors (and even channels!).

Distribution

zobtube is distributed as a binary and as a docker image.

It currently supports:

  • Linux linux-amd64
  • MacOS darwin-amd64
  • Windows windows-amd64

Those binaries are available on the Github release page.

If an architecture / operating system seems to be missing, feel free to request it on the issue section.

zobtube is also available using Docker images, give it a try!

docker run -it -p 8069:8069 ghcr.io/zobtube/zobtube

Configuration

ZobTube configuration is pretty straightforward. It can either be passed through environmental variables or through a configuration file. The configuration file would need to be stored in the directory where ZobTube is started.

If no configuration is provided at start, the application will display a minimalist interface to allow setting it on-the-fly.

Configuration Interface

For more examples on how the configuration can be set, feel free to refer to the Getting Started part of the Readme.

Here are some basic configuration.

Running locally with environmental variables

On Linux and MacOS:

ZT_SERVER_BIND="127.0.0.1:8069" ZT_DB_DRIVER=sqlite ZT_DB_CONNSTRING=./db.sqlite ZT_MEDIA_PATH=./data ./zobtube
Running in Docker with sqlite with configuration file

config.yml:

---
config:
  bind: "0.0.0.0:8069"
db:
  driver: "sqlite"
  connstring: "/var/lib/zobtube/zt.db"
media:
  path: "/var/lib/zobtube/data"

Then run with the following docker command:

docker run -v ./config.yml:/config.yml -v ./zt-test:/var/lib/zobtube --user 1000:1000 -p 8069:8069 ghcr.io/zobtube/zobtube

First start

During ZobTube first start, you will be prompted to create an admin user. This user will have all the rights on the application.

Initial admin setup

After the creation of this initial user, the application will restart and be in its nominal state.

Concepts

ZobTube allows sorting videos into several kinds:

  • Videos: Medium-length videos
  • Movies: Long videos, that usually contains several scenes
  • Clips: Short videos, easily scrollable, with a TikTok-like viewer

Each video can be associated to actors, channels, and categories.

Channels can be used to match production companies (like Brazzers) or creator feed (like a content creator on OnlyFans).

Categories are fully customizable, allowing them to reflect personal preferences.

Actors informations can be retrieved from well-known platforms:

  • Babepedia
  • Babes Directory
  • Boobpedia
  • PornHub

If you think a provider is missing and could be integrated, feel free to create a feature request

Triage

ZobTube is a tool aiming to help sorting videos. To achieve this, all videos are initially stored in the /triage folder. You can place them directly inside it or upload them through the upload window.

A video in triage can then be imported (by selected its kind: video, movie or clip).

Once imported, the video will be moved a new dedicated folder (depending on its kind), the duration will be computed (using ffmpeg) and a thumbnail will be generated (also using ffmpeg).

The video will then be editable, allowing to add channels, actors and categories.

Credits

ZobTube is an open-source software, based on open-source software.

For ZobTube
For this website