ZEITGEIST-DAEMON(1)

NAME
zeitgeist-daemon - D-Bus interface providing a log of activities

SYNOPSIS
zeitgeist-daemon [OPTION]

DESCRIPTION
zeitgeist-daemon is a daemon which keeps track of activities on your system (file usage, browser history, calendar events, etc.) and logs them into a central database. It does not only create a chronologic register, but also supports tagging and can establish relationships between activities.

All this information is provided by external applications which communicate with zeitgeist-daemon over D-Bus. Interested programs can connect with it and request information, insert new items or modify existing information (delete items, add tags, bookmark items and so on).

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.

--no-datahub, --no-passive-loggers
    Do not start zeitgeist-datahub together with this daemon.

--replace
    Replace any existing Zeitgeist instance if there is one already running. If this option isn't used, zeitgeist-daemon will refuse to start if another running instance is found.

--log-level=LOG_LEVEL
    Specifies how much information should be printed to the standard output. Possible values are: DEBUG, INFO, WARNING, ERROR, CRITICAL.

--quit
    Stop a currently running Zeitgeist instance and exit. This lets Zeitgeist finish any operation it may currently be doing.

--version
    Shows which version of Zeitgeist is being executed.

--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_DEFAULT_EXTENSIONS
    This variable lets you specify an override for the extensions which are loaded at daemon startup time. Per default the 'Blacklist' and the 'DataSourceRegistry' extension are loaded.

ZEITGEIST_EXTRA_EXTENSIONS
    This variable lets you add extensions which are loaded at daemon startup time.

The ZEITGEIST_DEFAULT_EXTENSIONS and the ZEITGEIST_EXTRA_EXTENSIONS
    variable require a no-space comma separated list of module.class names.

ZEITGEIST_DEBUG_QUERY_PLANS
    When set to a non-empty string other than 0 zeitgeist-daemon will send all SQL queries and their corresponding query plans to the debug log.

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.

EXIT CODES

0   Zeitgeist terminated normally.

1   An unspecified error occurred.

27  A database upgrade failed.

EXAMPLES

environment variables

To start the daemon with no extensions loaded run:
    ZEITGEIST_DEFAULT_EXTENSIONS= zeitgeist-daemon

To run the daemon with only the non-default extensions 'bzr.notify' and 'tracker.games' run:
    ZEITGEIST_DEFAULT_EXTENSIONS= ZEITGEIST_EXTRA_EXTENSIONS=bzr.notify,tracker.games zeitgeist-daemon

SEE ALSO
zeitgeist-datahub, gnome-activity-journal

BUGS
Please report any bugs on https://bugs.launchpad.net/zeitgeist.

AUTHORS
Please see the AUTHORS file bundled with this application for a complete list of contributors.

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/>.