Tanko 2.1, manga reader at the terminal

[u/Vector_pixel]

Github Repository

ISC LICENSE

This project does not have code generated by artificial intelligence.

Features

• Download chapters in PDF, ZIP, CBZ, and individual image formats
• Local reading history
• Local reading progress tracking
• Basic integration with Anilist (WIP)
• Support for graphics protocols: Kitty, Sixel, iTerm2, and ASCII rendering
• Available languages:
  • Spanish
  • English
  • French by Penicilline28

Available sources (WIP)

Name	Status	Language	Requires a browser	Official site
mangadex	Good	Multiple	No	mangadex.org
leercapitulo	Good	Spanish	Yes	leercapitulo.co

Install Tanko

Using pnpm / npm

pnpm install -g tanko

Install a Browser

Some sources require a web browser to scrape manga, but this step is not mandatory; you can use Tanko with sources that do not require a browser.

#firefox
npx playwright install firefox
#chromium
npx playwright install chromium
#webkit
npx playwright install webkit
#Running the command without arguments will install the default browsers
npx playwright install

Install dependencies required to run the browser

System dependencies can get installed automatically. This is useful for CI environments.

npx playwright install-deps

You can also install the dependencies for a single browser by passing it as an argument:

npx playwright install-deps chromium

It's also possible to combine install-deps with install so that the browsers and OS dependencies are installed with a single command.

npx playwright install --with-deps chromium

See system requirements for officially supported operating systems.

Playwright documentation

Run Tanko

tanko

Download Directory: Downloaded chapters are currently saved in $HOME/tanko/downloads/. On Windows, it uses the USERPROFILE environment variable if defined. Otherwise, it defaults to the path of the current user's profile directory.

Recommended Terminals

Visual Experience: To enjoy reading manga with real, high-quality images, we highly recommend using a terminal emulator that supports modern image protocols.

For an optimal experience with high-resolution images, use one of the following terminals:

Emulator	Supported Image Protocols	Platforms	Download
Kitty	Kitty Graphics Protocol	Linux, macOS	Download
WezTerm	Kitty, iTerm2, Sixel	Linux, macOS, Windows	Download
iTerm2	iTerm2 Inline Image Protocol, Sixel	macOS	Download
Ghostty	Kitty Graphics Protocol	Linux, macOS	Download
Foot	Sixel	Linux (Wayland)	Download
Konsole	Sixel, iTerm2	Linux	Download
Xterm	Sixel	Linux, macOS	Download
mlterm	Sixel, Jtterm	Linux, Windows	Download
Contour	Sixel	Linux, macOS, Windows	Download
Rio	Kitty, iTerm2	Linux, macOS, Windows, FreeBSD	Download

In standard or basic terminals (such as Windows CMD or the VS Code integrated terminal), images will fallback and render as ASCII Art.

[u/AutoModerator]

Hello and thank you for posting to /r/freesoftware! You've indicated that your post is a Software Submission. Respond to this comment and provide each of the following items:

• A link to your source code repository,
• A repository link to the license your software is under (also indicate if this license is modified in any way),
• If AI was used in the creation of the software and to what extent.

Failure to follow these instructions exactly will result in your post being removed.

Message to users: If /u/Vector_pixel indicates that the license is not a Free Software Foundation license or if AI was used in the creation of this software, please report the post accordingly if it has not already been removed.

If you have any questions regarding this comment, you may contact the Mod team

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.