• Features
• Dependencies
• Installation
• Image rendering
• Usage
• Manga providers
• Configuration
• Motivation
• Credits

• Mangadex, Weebcentral and MangaPill are available as manga providers (many more willl be added!) so if any one goes down you can still use manga-tui

• Track your reading history with anilist integration

• Advanced search (with filters)

• Read manga in your terminal with terminals such as: Wezterm, iTerm2, Kitty, Ghostty

• Reading history is stored locally (with no login required)

• Download manga (available formats: cbz, epub, pdf and raw images)

• Download all chapters of a manga (available formats: cbz, epub, pdf and raw images)

On linux you may need to install the D-bus secret service library

sudo apt install libdbus-1-dev pkg-config

sudo dnf install dbus-devel pkgconf-pkg-config

sudo pacman -S dbus pkgconf

cargo install manga-tui --locked

You can install manga-tui from the AUR with using an AUR helper.

paru -S manga-tui

If you have the Nix package manager, this repo provides a flake that builds the latest git version from source.

Simply run the following:

nix run 'github:josueBarretogit/manga-tui'

Or, to install persistently:

nix profile install 'github:josueBarretogit/manga-tui'

Download a binary from the releases page

Use a terminal that can render images such as Wezterm (Personally I recommend using this one It's the one used in the videos), iTerm2, Kitty and Ghostty
For more information see: image-support

No images will be displayed if the terminal does not have image support (but manga-tui will still work as a manga downloader)

After installation just run the binary

manga-tui

By default when you run manga-tui Mangadex will be used

manga-tui

If you want to use Weebcentral or any other provider available then run:

manga-tui -p weebcentral

The config file is located at XDG_CONFIG_HOME/manga-tui/config.toml, to know where it is you can run:

manga-tui --config-dir # or manga-tui -c

Which provides the following configuration:

# The format of the manga downloaded # values: cbz, raw, epub, pdf # default: "cbz" download_type = "cbz" # Download image quality, low quality means images are compressed and is recommended for slow internet connections # values: low, high  # default: "low" image_quality = "low" # Pages around the currently selected page to try to prefetch # values: 0-255 # default: 5 amount_pages = 5 # Whether or not bookmarking is done automatically, if false you decide which chapter to bookmark # values: true, false # default: true auto_bookmark = true # Whether or not downloading a manga counts as reading it on services like anilist # values: true, false # default: false track_reading_when_download = false # Enable / disable checking for new updates # values: true, false # default: true check_new_updates = true # Sets which manga provider will be used when running manga-tui,  # you can override it by running manga-tui with the -p flag like this: manga-tui -p weebcentral # values: mangadex, weebcentral, mangapill # default: "mangadex" default_manga_provider = "mangadex" # Enable / disable tracking reading history with services like `anilist` # values: true, false # default: true track_reading_history = true # Anilist-related config, if you want `manga-tui` to read your anilist credentials from this file then place them here [anilist] # Your client id from your anilist account # leave it as an empty string "" if you don't want to use the config file to read your anilist credentials # values: string # default: "" client_id = "" # Your acces token from your anilist account # leave it as an empty string "" if you don't want to use the config file to read your anilist credentials # values: string # default: "" access_token = ""

Manga downloads and reading history is stored in the manga-tui directory, to know where it is run:

manga-tui --data-dir # or manga-tui -d

On linux it will output something like: ~/.local/share/manga-tui

On the manga-tui directory there will be 3 directories

• history, which contains a sqlite database to store reading history
• mangaDownloads, where manga will be downloaded
• errorLogs, for storing posible errors / bugs

If you want to change the location of this directory you can set the environment variable MANGA_TUI_DATA_DIR to some path pointing to a directory, like:

export MANGA_TUI_DATA_DIR="/home/user/Desktop/mangas"

# `es` corresponds to the Iso code for spanish manga-tui lang --set 'es'

manga-tui lang --print

I wanted to make a "How linux user does ..." but for manga, here is the video also this is a great excuse to start reading manga again

Many thanks to Mangadex for providing the free API please consider supporting them ❤️
Many thanks to the Ratatui organization for making such a good library for making TUI's in rust 🐭
Many thanks to the developer of the Ratatui-image crate for providing a widget that renders images in the terminal 🖼️

Consider giving a star to this project ⭐