home | help
himitsu.ini(5)		       File Formats Manual		  himitsu.ini(5)

NAME
     himitsu.ini - configuration file for himitsu(7)

FILE FORMAT
     The  Himitsu  configuration  file	is  an	INI file. Each set of options is
     grouped into sections, which are indicated by the section	name  surrounded
     by  square  brackets (e.g. [himitsud]) on a line. Following each section, a
     set of key/value pairs belonging to that section are provided. The keys are
     separated from the values by an equal symbol (=).

     The default configuration file is installed by himitsu-store(1).

APPLICATION USAGE
     The set of configuration parameters recognized by the Himitsu  distribution
     are  specified  below.  Third-party software providing Himitsu integrations
     are encouraged to configure themselves using this	file.  Any  sections  or
     keys  which are not understood by any particular application will be disre-
     garded.

   HIMITSUD
     himitsud(1)-related options are placed into  the  [himitsud]  section.  The
     available options are:

     notify-reuse
	 An optional shell command to run when a client uses a "remembered" con-
	 sent.	The  "query"  shell variable is set to the query which was used.
	 For example, to show a dbus notification with notify-send(1) whenever a
	 remembered query is used:

	     [himitsud]
	     notify-reuse=notify-send "Himitsu key access" "$query"

	 The notify-reuse command is expanded with wordexp(3) before being  exe-
	 cuted,  and  both the expansion and the notify command are run with the
	 same credentials as himitsud(1).

     prompter
	 Configure the path to the prompter executable which will be used to in-
	 teract with the user for consent requests and key store  unlock  opera-
	 tions.  See himitsu-prompter(5) for a description of the protocol which
	 should be implemented by this executable.

SEE ALSO
     himitsu(7)

AUTHORS
     Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by  other  con-
     tributors. Up-to-date source code can be found at https://git.sr.ht/~sircm-
     pwn/himitsu,  and	bugs/patches can be submitted by email to ~sircmpwn/him-
     itsu-devel@lists.sr.ht.

				   2026-08-27			  himitsu.ini(5)

home | help