NOAFtodo manpage

• Home page
• Guide (manpage)

NOAFTODO(1)                    NOAFtodo man page                   NOAFTODO(1)



NAME
       NOAFtodo A TODO manager No-One-Asked-For.

SYNOPSIS
       noaftodo [OPTIONS]

       noaftodo -d [OPTIONS]

       naoftodo -r

       noaftodo -h

DESCRIPTION
       NOAFtodo  is  a simple ncurses TODO-manager. Also includes a deamon for
       tracking task dues and completion.

OPTIONS
       -C, --command

              execute a command

       -c, --config

              specify config file

       -d, --daemon

              start daemon

       -h, --help

              print help message

       -I, --interpreter

              start in interpreter mode. Argument after it will be executed as
              a command

       -k, --kill-daemon

              kill daemon

       -l, --list

              specify list file

       -p, --pure

              use pure output. No intents, no time, just text

       -r, --refire

              if  daemon  is  running, re-fire startup events (like, notifica‐
              tions)

       -v, --verbose

              print all messages

       -V, --version

              print program version

COMMAND MODE
   COMMANDS
       :a <due> <title> <description>[ <id>]

              add or override a task. If <id> is not specified, a new task  is
              created. If not, a task with <id> will be overriden.

       :alias <command>

              create an alias for command.

       :bind <key> <command> <mode> <autoexec>

              bind  <key> to <command>. <mode> speciifes, which modes use this
              bind (mask, see noaftodo_cui.h for MODE_* values). If <autoexec>
              is  "true",  execute  command on key hit, otherwise just go into
              command mode with it. Running as just  "bind  <key>"  removes  a
              bind.

       :!<command>

              execute shell command

       :!!<command>

              execute shell command, don't track output (for lauching programs
              that have a TUI or something

       :d

              remove selected task.

       :echo[ args...]

              print the following in status.

       :exec <filename>[ script]

              execute a config file. Execute default  config  with  "exec  de‐
              fault". With "script" cvars from config are not set as default

       :if <true|false> <do-if-true>[ <do-if-false>]

              simple if expression

       :lclear

              clear list.

       :load <filename>

              load the list file

       :math <num1> <op> <num2>[ <name>]

              calculate  math  expression (+,-,/,*,=,<,>,min,max) and write to
              cvar <name>. If <name> is not specifed, just  print  the  result
              out

       :q

              exit the program.

       :save[ <filename>]

              force  the  list  save. If <filename> is not specified, override
              opened file.

       :setmeta[ <name1> <value1>[ <name2> <value2>[ ...]]]

              set task meta. If no arguments are specified, clear  task  meta.
              To   add   properties  to  meta,  use  "setmeta  %meta%  <name1>
              <value1>...". "setmeta <name>" will erase only <name> meta prop‐
              erty

       :set <name>[ <value>]

              set  cvar  value. If <value> is not specified, reset cvar to de‐
              fault value.

       :ver <VERSION>

              is used to specify config version to notify about possible  out‐
              dated config files.

NORMAL MODE COLUMNS
       NORMAL  mode  columns  are specified in "norm.cols.all" and "norm.cols"
       cvars (for when all lists/only one list is viewed correspondingly). You
       can  also  set  some  NORMAL  mode columns to display their values with
       "det.cols".

       D

              shows task description

       d

              shows task due

       f

              shows task flags

       i

              shows task ID (as referred by UI, don't confuse with task unique
              ID)

       l

              shows what list the task is attached to

       t

              shows task title

LISTVIEW MODE COLUMNS
       LISTVIEW mode columns are set in "det.cols" cvar.

       e

              shows the amount of entries attached to the list

       f

              shows list flags

       i

              shows list number (aka ID)

       p

              shows the precentge of completed entries on the list

       t

              shows list title

STATUS FIELDS
       Status  fields  are  specified  in  "norm.status_fields" and "livi.sta‐
       tus_fields" cvars for NORMAL and LISTVIEW correspondingly.

       f

              shows filters

       i

              shows selected task ID and a total amount of entries

       l

              shows current list name

       m

              shows current mode (NORMAL|LISTVIEW|DETAILS|HELP)

       P

              shows the amount of completed entries on the  list  against  the
              total amount of attached entries

       p

              shows the percentage of completed entries on a current list

       s

              shows status value (output of commands)

TROUBLESHOOTING
   CONFIG VERSION MISMATCH
       Means that your config is declared for the other vesion of noaftodo. Go
       through list file and all config files you have included,  and  replace
       config version numbers in all "ver " commands (also, you would probably
       need to update some commands in configs. For this, see program changel‐
       ogs on Github: https://github.com/GregTheMadMonk/noaftodo).

   LIST VERSION MISMATCH
       Open NOAFtodo. If list loaded correctly, re-save it to another location
       with ":save <filename>" (just ":save" won't work in safemode!).  <file‐
       name> could be the same as the list you have loaded, if you are a brave
       one. Program will save the list in correct format. If the  list  wasn't
       loaded correctly, you will have to modify it manually. Sad(

EPILOGUE
       Apology  for  bad  english  and  probably  not very useful manpage.  <3
       Y'all! Peace!



1.4.4                              July 2020                       NOAFTODO(1)