manga-tui

Manga-tui ️

Terminal-based manga reader and downloader written in rust 

Table of contents

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

Features

• 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)

Join the discord server for further help, feature requests or to chat with contributors

Dependencies

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

Debian

sudo apt install libdbus-1-dev pkg-config

Fedora

sudo dnf install dbus-devel pkgconf-pkg-config

Arch

sudo pacman -S dbus pkgconf

Installation

Using cargo

cargo install manga-tui --locked

AUR

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

paru -S manga-tui

Nix

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'

Binary release

Download a binary from the releases page

Image rendering

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

[!WARNING] On windows image display is very buggy, see this issue for more information

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

Usage

After installation just run the binary

manga-tui

Manga providers

[!WARNING] Expect any manga provider to fail at some point, either due to them closing operations due to a lawsuit or the provider itself having issues on their end like manganato

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

Configuration

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:

…

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"

[!NOTE] Mangadex-only feature By default manga-tui will search mangas in english, you can change the language by running:

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

[!NOTE] Mangadex-only feature Check the available languages and their Iso codes by running:

manga-tui lang --print

Motivation

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

Credits

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 ⭐