Gucken

Project state: Pre-Alpha

Description

Gucken is a Terminal User Interface which allows you to browse and watch your favorite anime's with style.

Usage

Installation

Windows

Install Python and if you are on Windows 10 Windows Terminal for a better experience.

pip install gucken
gucken

Linux

Install Python and then

pip install gucken
gucken

Android

Install Termux and run:

yes|pkg update
pkg install python ffmpeg -y
pip install gucken
gucken

Shortcut

Install Termux:Widget.

mkdir ~/.shortcuts

Lunch shortcut

echo gucken>~/.shortcuts/Gucken

Update shortcut

echo pip install -U gucken>~/.shortcuts/Update\ Gucken

Custom Font

If you want a custom font then just pace the ttf in ~/.termux/font.ttf. Recommended fonts: Nerd fonts (Only use Mono fonts!)

Downloads

Setup storage for downloads. (Default download location: /data/data/com.termux/files/home/storage/movies)

termux-setup-storage

Features

Update checker
Language priority list
Hoster priority list
Automatically use working hoster
Browsing
- Descriptions
Watching
- Trailer
- Automatically start next episode
- Discord Presence Very WIP
- MPV only
  - ani-skip support
  - Syncplay support (almost out of WIP)
  - Remember watch time WIP
  - Remember completed Episodes (and series)
- Tracker support
Downloading
- Watch from download

Provider

List of supported Anime sites

AniWorld.to & SerienStream.to
bs.to
www3.streamcloud.info
www.crunchyroll.com
Add some from International Piracy Sites German

Hoster

List of supported video hoster.

VEO
Vidoza
Doodstream
SpeedFiles
Vidmoly
Streamtape (Removed from AniWorld & SerienStream)
Luluvdo
LoadX
Filemoon

Player

List of supported video players

MPV (most features, recommended)
VLC
ffplay
Custom
Windows
- mpv.net
- wmplayer.exe (fallback on Windows)
Android
- mpv-android
- VLC
- Choose
Linux (Flatpack)
- MPV
- VLC
- Celluloid
Linux
- Celluloid
MacOS
- IINA

Custom CSS

For power users only

Place your custom CSS in user_config_path("gucken").joinpath("custom.css") and it will be automatically loaded by Gucken.

Optional dependencies

speedups (with: gucken[speedups])
- Faster fuzzy sort/search. (levenshtein)
- Faster json parsing. (orjson)
socks - SOCKS proxy support. (with: gucken[socks])

Todo

Privacy

Proxy support

Proxies can easiely be implented

for the http client in python
AsyncClient(proxy="http://...")
  
for the player mpv Note: mpv dos not support socks5
--http-proxy=<proxy>
FFmpeg: env.http_proxy
ytdl: --ytdl-raw-options=proxy=
  
yt-dlp
--proxy URL

Tor as proxy

AniWorld.to need Cloudflare captcha and JS challange
SerienStream.to can be bypassed by using diract ip
  
Cloudflare captcha and JS challange can be solved by using something like
selenium or playwright

DoH support
Reverse proxy for player
- DoH
- proxy

UX

Add hotkey to clear cache (F5)
Translation DE, EN
Improve settings design
Merge SerienStream.to and AniWorld.to search results
Focus window on autoplay popup
Utilize next and previous buttons in mpv
Chapters for VLC
Window in settings menu to show where files are located (data, logs, config, downloads)
s.to, aniworld.to scrape episode description
Search in episodes
Next and Cancel hotkeys
Show hotkeys in Footer
Create shortcut Windows & Linux
Installation helper
- MPV
  - Anime4k
- VLC
Colors themes

Speedups

Pre-fetching
More threads and asyncio.gather to make everything faster
More Caching
Reuse Client

Code

Do unescape and stripe only on render
Dont coppy code from SerienStream.to to AniWorld.to
BIG CODE CLEANUP

Features

Update checker option to perform update
Watchlist
New anime/series Notifications
Use something like opencv to time match a sub from aniworld with a high quality video form another site.
Nix package
Docker image
Flatpack package
Detect existing chapters and use them for skip
Reverse proxy for players that do not support headers
Up-scaling (after download)
- video2x
- waifu2x
- Real-ESRGAN
- FSRCNN
- Anime4k
Modular (Custom extractors/players, open API)
More CLI args
MPV Screen selection
Custom player args
Custom player
Anime4k options

Support

Mac support
IOS support
Support textual-web
Syncplay on Android
Improve Flatpack support
Improve Snap support

Bugs & DX

Logging and Crash reports
Blacklist detection & bypass
404 detection inside Hoster and don't crash whole program on http error + crash reports/logs
CI Testing (Windows, Linux)

Metadata

Release files for gucken 0.3.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gucken 0.3.9
File	Size	Uploaded
gucken-0.3.9.tar.gz	33.8 kB	Oct 2, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for gucken 0.3.9
File	Interpreter	ABI	Platform	Reset
gucken-0.3.9-py2.py3-none-any.whl 50.6 kB Oct 2, 2025	Python 2, Python 3	none	any	Details

Total release size: 84.4 kB

Release files / gucken-0.3.9.tar.gz

Download URL	gucken-0.3.9.tar.gz
Size	33.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`5a100be25696711c18b898fd73d5a8d61e1de31d2378e95ea1a43cab88925b53`
BLAKE2b-256 checksum How to use checksums	`2399a220beb4518b6330754e33506a27e67abc740a03b15b9cb4b5e0a2da2807`
Upload date	Oct 2, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.2`

Release files / gucken-0.3.9-py2.py3-none-any.whl

Download URL	gucken-0.3.9-py2.py3-none-any.whl
Size	50.6 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`9bdad88fbb56a8ac6c348acee3708a909498a16da7e940bcbcc807421a0e21dc`
BLAKE2b-256 checksum How to use checksums	`d2fc5a6b2c7b0081c734f2cf590287a115301aa6de96ad2fd0d75ab62ba79e06`
Upload date	Oct 2, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.2`