mangadesk ๐Ÿ“–

September 22, 2023 ยท View on GitHub

mangadesk ๐Ÿ“–

Top Language License Go Report Downloads

Note: Maintenance mode. Only severe bugs may be fixed.

The ultimate MangaDex terminal client!

demo.gif

Features โœจ

  • Download chapters straight to your computer.
  • Login to keep track of your followed manga.
  • Download multiple chapters together.
  • Searching!
  • (Yes, you can use this to scrape manga).
  • Written in Golang :)

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 โŒจ

OperationBinding
Login/LogoutCtrl + L
Keybindings/HelpCtrl + K
SearchCtrl + S
Next/Prev PageCtrl + F/B
EscapeEsc
Select a chapterCtrl + E
Toggle select all chaptersCtrl + A
Toggle chapter(s) read status

*Note: You can select multiple chapters to toggle!
Ctrl + R
Toggle manga followingCtrl + 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 ๐Ÿง 

  • Creating TUIs with tview/tcell.
  • Working with the filesystem in Golang.
  • Goroutines & Context.
  • Go project structure.