darylhjd / mangadesk

Terminal client for MangaDex 📖
MIT License
760 stars 29 forks source link
cli downloader go golang manga manga-downloader mangadex mangadownloader terminal terminal-app terminal-based tui tview
# mangadesk 📖 [![Top Language](https://img.shields.io/github/languages/top/darylhjd/mangadesk?style=flat-square)](https://github.com/darylhjd/mangadesk/search?l=go) [![License](https://img.shields.io/github/license/darylhjd/mangadesk?style=flat-square&color=blue)](https://github.com/darylhjd/mangadesk/blob/main/LICENSE) [![Go Report](https://goreportcard.com/badge/github.com/darylhjd/mangadesk?style=flat-square)](https://goreportcard.com/report/github.com/darylhjd/mangadesk) [![Downloads](https://img.shields.io/github/downloads/darylhjd/mangadesk/total?style=flat-square&color=success)](https://github.com/darylhjd/mangadesk/releases) **Note: Maintenance mode. Only severe bugs _may_ be fixed.**

The ultimate MangaDex terminal client!

demo.gif

Features ✨

Works for Windows/Linux/macOS.

Installation 🔧

This application runs as a standalone executable, and does not need to be installed.

Check out the Releases Page for new releases. To update, just download the latest release.

For bleeding edge 🗡 updates, you may also compile from source:

$ git clone https://github.com/darylhjd/mangadesk.git
$ cd mangadesk
$ go get -d ./...
$ go build

Arch Linux

Mangadesk is available through the AUR and may be installed as such (thanks @AmaanHUB!). It may be installed manually or with your preferred AUR helper:

$ paru -S mangadesk

Ubuntu

Mangadesk is available through the MPR and can be installed manually or with your preferred MPR helper:

$ una install mangadesk

Void Linux

Mangadesk is available through the official Void repositories and can be installed via XBPS:

$ xbps-install -S mangadesk

Uninstall ❌

To uninstall, simply delete the executable and its related folders and files.

Your downloads will not be removed by deleting the executable.

Arch Linux

Uninstall with an AUR helper or with pacman:

$ pacman -R mangadesk

Ubuntu

Uninstall with a MPR helper or with APT:

$ una remove mangadesk

Void Linux

Uninstall with XBPS:

$ xbps-remove -R mangadesk

Usage ✍

To run the application, navigate to the directory where you stored the executable, and run the following command:

$ ./mangadesk

Steps may differ for different OSes. For example, in Windows, use a backslash \ instead.

Keybindings ⌨

Operation Binding
Login/Logout Ctrl + L
Keybindings/Help Ctrl + K
Search Ctrl + S
Next/Prev Page Ctrl + F/B
Escape Esc
Select a chapter Ctrl + E
Toggle select all chapters Ctrl + A
Toggle chapter(s) read status

*Note: You can select multiple chapters to toggle!
Ctrl + R
Toggle manga following Ctrl + Q

Settings ⚙

Refer to this document for configurable settings.

Issues ☠

Check out the Issues page for current issues/feature requests.

Contributing 🤝

Always welcome and appreciated :)

Please take some time to familiarise yourself with the contributing guidelines.

Learning Points 🧠