Skip to main content

Configuration

Use this section to understand the desktop application's persisted settings and storage locations.

Configuration topics:

  • Player for Player-specific application settings
  • KLV for KLV decoding settings used during ingest and in the Player
  • This page for local database storage and database-path overrides

⛁ Database Location​

The application stores its local SQLite database as stinspector.db.

Windows​

On Windows, the desktop runtime creates the database under the current user's roaming application-data directory:

  • %AppData%\ImpleoTV\StInspector\data\stinspector.db

In practice, this typically resolves to a path similar to:

  • C:\Users\<username>\AppData\Roaming\ImpleoTV\StInspector\data\stinspector.db

If the data directory does not already exist, the application creates it on startup.

Linux​

On Linux, the desktop runtime follows the XDG data-directory convention.

If XDG_DATA_HOME is set, the database is created at:

  • $XDG_DATA_HOME/ImpleoTV/StInspector/data/stinspector.db

If XDG_DATA_HOME is not set, the application falls back to:

  • ~/.local/share/ImpleoTV/StInspector/data/stinspector.db

If the data directory does not already exist, the application creates it on startup.

macOS​

On macOS, the desktop runtime stores the database under the current user's Application Support directory:

  • ~/Library/Application Support/ImpleoTV/StInspector/data/stinspector.db

In practice, this typically resolves to a path similar to:

  • /Users/<username>/Library/Application Support/ImpleoTV/StInspector/data/stinspector.db

If the data directory does not already exist, the application creates it on startup.

Overriding The Database Path​

On any platform, you can override the default database location by setting the STINSPECTOR_DB_PATH environment variable before starting the application.

Examples:

  • Windows: STINSPECTOR_DB_PATH=D:\StInspector\stinspector.db
  • macOS: STINSPECTOR_DB_PATH=/Users/<username>/Library/Application Support/StInspector/custom.db
  • Linux: STINSPECTOR_DB_PATH=/srv/stinspector/stinspector.db

When STINSPECTOR_DB_PATH is set explicitly, the application uses that path instead of the platform default.