A console manga and doujinshi manager - a curses tool to help you keep track of your mangas and doujins
track — a simple tool to keep track of your mangas and doujins.
track [OPTIONS] [ARGS]
track is a program that enables the user to keep track of
mangas and doujins. Most options require the current directory
to be a permitted directory, which is any subdirectory
of $HOLY_DIR. Without any option provided, this is a curses
application and displays the files in the holy directory with a cursor
to move around and some useful keybindings.
The directory $HOLY_DIR is also referred to as the holy directory.
There are different tags for the subdirectories. These are :
These tags are maintained by creating blank files .READ, .FAV in the
subdirectory. The information for continue point is stored in a file .CONT.
-h, —help
Show a short help message and exit.
-r, —read
Toggle the READ tag for the current directory, only if the current
directory is a permitted subdirectory.
-f, —fav
Toggle the FAVORITE tag for the current directory, only if the
current directory is a permitted subdirectory.
-o MODE, —open MODE
Open the first page of first chapter of a random subdirectory in the
default image viewer according to MODE specified.
The MODES are :
-c CHAPTER PAGE, —cont CHAPTER PAGE
Set a new continue point for the current permitted subdirectory or
remove an already existing continue point. To set a new continue point,
run the program as :
$ track -c [CHAPTER] [PAGE]
This will set the continue point to chapter CHAPTER, page PAGE. If
both CHAPTER and PAGE are less than or equal to 0, the already existing
continue point is removed. If the chapter is less than or equal to 0 but
the page is not, chapter is assumed to be 1.
-p, —preview
Open the first page of the first chapter of the current permitted
subdirectory.
-s, —status
Print the status of all the three tags for the current permitted
subdirectory. If the tag is on, a GREEN tick mark is printed before
the tag. If it is off, a RED cross mark is printed before it.
—version
Print version information of program and exit.
The path to directory is taken from multiple sources. The preference order is:
$HOLY_DIR can be set to the path of the directory where you store your doujins.
If it is not set, the directory is assumed to be $HOME/Doujinshi or read from the config file.
A configuration file “.trackrc” can be placed in the home directory if you don’t want to
specify an environment variable. The file will be in yaml format.
The directory is set as:dir : [PATH-TO-DIRECTORY]
The Doujinshi files need to be organized in a specific manner:
If no options are provided, track is a curses application that
displays the files in the holy directory with a cursor to move around
and some useful keybindings. The subdirectories are displayed in
different colors according to their tags. The colors are :
There is also a status bar at the bottom of the screen with information
about the subdirectory under the cursor. At the left, there is the name
of the main section in which the cursor is. Any one of the following :
Then there is information in form of [ - r f ] or [ u - f ]. In this, u
indicates unread, r indicates read and f indicates favorite tag status
for the subdirectory under cursor. If the tag is off, ‘-‘ (dash) is
displayed.
Then total number of pictures in the subdirectory under cursor is displayed.
An asterisk (*) at the end of pictures indicates that there are nested
subdirectories. Finally, the number of chapters for that subdirectory
is displayed.
If the subdirectory under cursor has a continue point set, the chapter
and page of the continue point is displayed as [c : CHAPTER and p :
PAGE] at the end of the cursor.
j, DOWN
Move one row down
k, UP
Move one row up
^D, J
Move half page down
^U, K
Move half page up
g, HOME
Move to first file
G, END
Move to last file
r
Toggle READ tag for subdirectory under cursor
f
Toggle FAVORITE tag for subdirectory under cursor
c
Set continue point for subdirectory under cursor. First, a textbox with
title “c” will appear in which you need to input chapter number for the
continue point. Then, textbox with title “p” will appear in which you
need to input page number for the continue point. If the continue point
given exists (the subdirectory has that page in that particular
chapter), it is marked. Otherwise, a red flash goes off to inform user
of error. Give 0 or less for both values to remove an already existing
continue point. If chapter is <= 0 but page is not, chapter is
assumed to be 1
l, RIGHT
Open first page or continue point (if set) for the subdirectory under
cursor in default image viewer
p, SPACE
Open the first page of subdirectory under cursor (regardless of continue
point) in the default image viewer
/
Search for term in names of directories after cursor till end of files
(no loopback)
n
Go to next file that contains the last search term (no loopback)
N
Go to previous file that contains the last search term (no loopover)
i
Show the number of subdirectories in each tag and basic information
about subdirectory under cursor
q
Close info window if visible otherwise, exit
ESC
Close info window or text-box if visible
0.1.1