ZEITGEIST-DAEMON(1)

✨ NAME ✨

zeitgeist-daemon β€” a D-Bus interface that lowkey keeps a whole log of your activities πŸ’…


🌸 SYNOPSIS 🌸

zeitgeist-daemon [OPTION]

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so bestie, zeitgeist-daemon is a daemon that runs an activity log. like, it's literally a central database for events β€” file usage, browser history, calendar entries, etc. all of it. πŸ’–

and the way it works is, all that info gets made available to external applications, which talk to zeitgeist-daemon over D-Bus. interested apps can request information, insert new events, or delete existing events. full main character energy, honestly.

Zeitgeist is also capable of establishing relationships between activities. its whole purpose is enabling an activity-aware desktop with adaptive user interfaces. iconic.

by default, zeitgeist-daemon will also start the bundled logging application zeitgeist-datahub. πŸŽ€


✨ OPTIONS ✨

the program follows the usual GNU command line syntax, with options starting with two dashes (`--`). a summary of options is included below, mwah πŸ’‹

  • --no-datahub β€” do not start zeitgeist-datahub together with this daemon. like, she flies solo on this one.
  • -r, --replace β€” replace any existing Zeitgeist instance if there's one already running. and ngl, if you don't use this option, zeitgeist-daemon will straight up refuse to start when it finds another running instance. no cap. πŸ™ˆ
  • --log-level=LOG_LEVEL β€” specifies how much information should be printed to the standard output. possible values are: DEBUG, INFO, WARNING, ERROR, CRITICAL. pick your yap level bestie.
  • --log-file=LOG_FILE β€” specifies a file to which log output will be appended.
  • -q, --quit β€” stop a currently running Zeitgeist instance and exit. this lets Zeitgeist finish any operation it may currently be doing. she's not messy, she cleans up after herself. πŸ’…
  • -v, --version β€” shows which version of Zeitgeist is being executed.
  • -h, --help β€” shows a short help message listing all supported options.

🫢 ENVIRONMENT VARIABLES 🫢

  • ZEITGEIST_DATA_PATH β€” overrides the directory where user data files are placed. the default value is that of XDG's data dir (usually ~/.local/share/zeitgeist). ✨
  • ZEITGEIST_DATABASE_PATH β€” this variable lets you specify an override for the filename of the main database. the default value is $ZEITGEIST_DATA_PATH/activity.sqlite.
  • ZEITGEIST_DATABASE_BACKUP_PATH β€” this variable lets you specify an override for the filename of a possible database backup. the default value is $ZEITGEIST_DATA_PATH/activity.sqlite.bck.
  • ZEITGEIST_DISABLED_EXTENSIONS β€” this variable lets you specify a comma separated list of extension names which shouldn't be loaded. the names are extracted from type names of the extensions, so to disable an extension with type name ZeitgeistDataSourceRegistry, the value of the variable should be DataSourceRegistry. iykyk 🧚

⭐ SIGNALS ⭐

  • SIGHUP: zeitgeist-daemon will shut itself down in a clean way. it is recommended that system updates of Zeitgeist send this signal to all running instances of zeitgeist-daemon. DBus activation will make sure the updated software is automatically restarted when needed. she logs off gracefully and comes back even hotter. πŸ‘‘

🌈 EXIT CODES 🌈

  • 0 β€” Zeitgeist terminated normally. πŸ₯³
  • 1 β€” an unspecified error occurred. πŸ’€
  • 10 β€” there is already a running Zeitgeist instance.
  • 21 β€” could not access the database file.
  • 22 β€” the database file is locked.

πŸ”₯ SEE ALSO πŸ”₯

zeitgeist-datahub, gnome-activity-journal


πŸ’€ BUGS πŸ’€

please report any bugs on https://gitlab.freedesktop.org/zeitgeist/zeitgeist/issues β€” do it for the girls 🫢


πŸ‘‘ AUTHORS πŸ‘‘

please see the AUTHORS file bundled with this application for a complete list of contributors. stan them fr fr.


πŸ’œ LICENSE πŸ’œ

this program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 2.1 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU Lesser General Public License for more details.

you should have received a copy of the GNU Lesser General Public License along with this program. if not, see <http://www.gnu.org/licenses/>.


okay that's the whole vibe check βœ… this was Zeitgeist, dated June 28, 2012, and that's your ZEITGEIST-DAEMON(1) moment β€” slay, stay logged, and don't forget to close your tags bestie πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from