gucken 0.1.11

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

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
    • MyAnimeList
    • AniList
    • AniWorld.to & SerienStream.to
• Downloading
  • Watch from download

Provider

List of supported Anime sites

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

Hoster

List of supported video hoster.

• Streamtape
• VEO
• Vidoza
• Doodstream

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.

• Textual CSS Guide
• Textual CSS Reference

Optional dependencies

• levenshtein - Faster fuzzy sort/search. (with: gucken[levenshtein])
• socks - SOCKS proxy support. (with: gucken[socks])

Todo

• Up-scaling (after download)
  • video2x
  • waifu2x
  • Real-ESRGAN
  • FSRCNN
  • Anime4k
• Proxy support

  Note:
  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

  Note:
  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
  

• MPV Screen selection
• Custom player args
• Custom player
• Colors themes
• Installation helper
  • MPV
    • Anime4k
  • VLC
• Create shortcut Windows & Linux
• CI Testing (Windows, Linux)
• CD pip
• Anime4k options
• Modular (Custom extractors/players, API)
• Proper error handling
• Logging and Crash reports
• Pre-fetching
• Use something like opencv to time match a sub from aniworld with a high quality video form another site.
• Image preview (Kitty protocol, iterm protocol, Sixel, textual-web)
• Support textual-web
• Blacklist detection & bypass
• Mac support
• IOS support
• Update checker option to perform update
• Snap support ?
• 404 detection inside Hoster and don't crash whole program on http error + crash reports/logs
• s.to, aniworld.to scrape episode description
• search in episodes
• Focus window when ask next
• next and cancel hotkeys
• show hotkeys in Footer
• Window in settings menu to show where files are located (data, logs, config, downloads)
• Utilize next and previous buttons in mpv
• Nix
• Docker
• Flatpack ?
• Merge anime's from SerienStream.to to AniWorld.to to get more langs
• Do unescape and stripe only on render
• Dont coppy code from SerienStream.to to AniWorld.to
• BIG CODE CLEANUP
• Translation
• detect existing chapters and use them for skip
• Better settings design
• FIX TYPING SOMETIMES CAUSES CRASH
• Syncplay on Android
• More CLI args
• reverse proxy
• Chapters for VLC
• DoH support
• More threads and asyncio.gather to make everything faster
• Watchlist
• Notifications