Skip to content

Customizing the dsu configuration file

Gene M. Angelo, Jr edited this page Feb 18, 2024 · 3 revisions

Locating the dsu configuration file

Your dsu configuration file will be in your respective operating system's home folder:

  • macOS: /Users/<username>/.dsu)
  • Linux: /home/<username>/.dsu
  • Windows: C:\Users\<username>\.dsu

You may edit the dsu configuration file to meet your needs. However, you should only customize the configuration file of an official dsu release (e.g. n.n.n, not n.n.n.alpha.n).

Configuration file options

Running the following command in your terminal will display the dsu configuration file options and settings...

dsu config info #=>
Screen Shot 2024-02-17 at 9 23 31 PM

version

DO NOT edit this value. This value coincides with the dsu migration version and should not be edited.

editor

This is the default editor to use when editing entry groups if the EDITOR environment variable on your system is not set.

Default: nano (you'll need to change the default editor on Windows systems)

NOTE: Visual Studio Code, users, use "code --wait" (or "code -w", short form) to make sure the vscode editor waits for the edited file to be saved and closed before returning control to the dsu process.

entries_display_order

Valid values are 'asc' and 'desc', and will sort listed DSU entries in ascending or descending order respectfully, by day.

Default: 'desc'

carry_over_entries_to_today

Applicable to the dsu edit command. Valid values are true|false. If true, when editing DSU entries for the first time on any given day (e.g. dsu edit today), DSU entries from the previous day will be copied into the current editing session. If there are no DSU entries from the previous day, dsu will search backwards up to 7 days to find a DSU date that has entries to copy. If after searching back 7 days, no DSU entries are found, the editor session will simply provide no previous DSU entries.

Default: false

include_all

Applicable to dsu commands that display DSU date lists (e.g. dsu list commands). Valid values are true|false. If true, all DSU dates within the specified range will be displayed, regardless of whether or not a particular date has entries. If false, only DSU dates between the first and last DSU dates that have entries will be displayed.

Default: false

theme_name

Valid values are any valid theme name listed as a result of running dsu theme list.

default_project

Designates the default project. It is only recommended that you change this value through the dsu UI (see Managing dsu Projects, Designating the default project)

Default: "default"