Awesome
<div align="center">mangadesk 📖
Note: Maintenance mode. Only severe bugs may be fixed.
<h3>The ultimate MangaDex terminal client!</h3> <img src=".github/assets/demo.gif" alt="demo.gif"> </div>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 :)
<b>Works for Windows/Linux/macOS.</b>
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 | <kbd>Ctrl</kbd> + <kbd>L</kbd> |
Keybindings/Help | <kbd>Ctrl</kbd> + <kbd>K</kbd> |
Search | <kbd>Ctrl</kbd> + <kbd>S</kbd> |
Next/Prev Page | <kbd>Ctrl</kbd> + <kbd>F/B</kbd> |
Escape | <kbd>Esc</kbd> |
Select a chapter | <kbd>Ctrl</kbd> + <kbd>E</kbd> |
Toggle select all chapters | <kbd>Ctrl</kbd> + <kbd>A</kbd> |
Toggle chapter(s) read status<br/><br/>*Note: You can select multiple chapters to toggle! | <kbd>Ctrl</kbd> + <kbd>R</kbd> |
Toggle manga following | <kbd>Ctrl</kbd> + <kbd>Q</kbd> |
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.