A command-line tool to fetch and view comics directly in your terminal.
comic-cat is a simple Bash script that allows you to search for comics on KomikCast, select chapters interactively, and view them using image viewer. It's designed for comic enthusiasts who prefer a terminal-based experience.
- Automatic image downloading and temporary storage
- Support for multiple image viewers (feh, eog, or default system viewer)
- Clean temporary file management
- Version and help options
-
Clone or download the repository:
git clone https://github.com/Fhanafii/comic-cat.git cd comic-cat -
Make the script executable:
chmod +x comic-cat.sh
-
(Optional) Add to your PATH for global access:
sudo cp comic-cat.sh /usr/local/bin/comic-cat
Run the script without arguments to start the interactive mode:
./comic-cat.shOr if added to PATH:
comic-cat-h, --help: Display help message-v, --version: Display version information
-
Run the script:
./comic-cat.sh
-
Enter the comic title when prompted (e.g., "One Piece").
-
Select a chapter from the list using the fuzzy finder.
-
The script will download the images and open them in your image viewer.
-
Close the viewer when done; temporary files are automatically cleaned up.
curl: For fetching web contentfzf: For interactive selection (install via package manager, e.g.,sudo apt install fzf)- Image viewer:
feh,eog, or any viewer supported byxdg-open
Install dependencies on Ubuntu/Debian:
sudo apt update
sudo apt install curl fzf feh # or eogThis project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.