Obsidian logging - Log to Obsidian Journal from command line
This little utility written in Rust makes it possible to log directly to todays daily note from the linux command line.
Installation
You can install obsidian-logging using cargo:
Or build from source:
Or download binaries directly from the github releases page.
Tip
Since obsidian-logging is quite a mouthful to type every time, it is recommended to create a short alias. E.g
alias q=` obsidian-logging`
(Note: the space before the program name stops the commaand from being entered into command history)
On Windows, the doskey command can be used to create a macro:
doskey q=obsidian-logging
Environment variable
If the environment variable $OBSIDIAN_VAULT_DIR has a value it is expected to poiny to the top level directory of the vault. If specified, it will override the value in obsidian-logging.yaml
Configuration file
Obsidian-logging reads ~/.config/obsidian-logging/obsidian-logging.yaml on startup. If it does not exist, obsidian-logging will create it and prompt for some of the values. This is a file that uses the yaml configuration format. See obsidian-logging.example.yaml for what can be configured.
Obsidian-logging looks for a marker that signifiies where the log entries block will start. Log entries must be consecutive without empty lines. The marker is specified in the config file.
Command line switches
No swithces
When invoking the command obsidian-logging This is a log entry obsidian-logging will append the string - HH:mm This is a log entry (where HH:mm) is the current timestamp ) to the markdown daily note.
-t or --time
The timestamp may be overridden by specifying the -t/--time HH:mm switch. Log entries are sorted chronobsidian-loggingically before being added to the md file.
-l or --list
You can list the current days log entries by specifying the -l option. If obsidian-logging is invoked without any arguments, this is the default action.
-b or --back
By specifying -b <number> you can go back in time and list the logs number of days ago. obsidian-logging -b 0 is the same as obsidian-logging -l
-e or --edit
Invokes $EDITOR with todays file. Uses vim if $EDITOR is not set,
-f or --time-format
Specifies 12H or 24H time format. 24H is default. Overrides time_format in obsidian-logging.yaml
-s or --silent
Do not output anything, not even error messages
-h or --help
Print command line argument help
-T list mode
Specifies the list output mode when obsidian-logging -l is called. Valid arguments are -T bullet and -T table. Overrides the list mode in obsidian-logging.yaml configuration file
-v or --version
Outputs the current version string and exits execution