Skip to content

Options

Jump to bottom
Anthony Beaumont edited this page Feb 25, 2022 · 11 revisions

Options are stored in %AppData%\Achievement Watcher\cfg\options.ini but most of them are configurable via the GUI

[achievement]

  • lang
    The language to use for both the UI and data fetching (if available; otherwise fall back to English)
    default to user locale

  • showHidden
    Whether or not to show hidden achievements (if any)
    default to false

  • mergeDuplicate
    Try to merge multiple achievement source for the same game
    default to true

  • timeMergeRecentFirst
    When merging duplicates, show the most recent timestamp instead of the oldest
    default to false

  • hideZero
    Hide '0% Game'
    default to false

  • thumbnailPortrait
    Game thumbnail orientation: classic or portrait mode (Like the new Steam UI)
    default to false

[achievement_source]

  • legitSteam
    Steam games : (0) none / (1) installed / (2) owned
    default to 0 (none)

  • steamEmu
    Import Steam Emu achievements
    default to true

  • greenLuma
    Import GreenLuma achievements stored in the registry
    default to true

  • rpcs3
    Import RPCS3 trophies
    default to true

  • lumaPlay
    Import lumaPlay achievements
    default to false

  • importCache
    Import Watchdog's (Notification) cache as another source of achievement
    Use this(true) + mergeDuplicate(true) + timeMergeRecentFirst(false) to correct/fix most SteamEmu quirks
    default to true

[notification]

  • notify
    Notify on achievement unlocking (if possible)
    (AchievementWatcher.exe doesn't need to be running for this, but the background process node.exe watchdog does)
    default to true

  • showDesc
    Show achievement description (if any)
    default to false

  • rumble
    Vibrate (force) first xinput controller when unlocking an achievement
    default to true

  • notifyOnProgress
    Notify on achievement progress (if available)
    default to true

  • playtime
    Notify on playtime tracking start/end
    default to true

[notification_toast]

  • customToastAudio
    Specifies the sound to play when a toast notification is displayed
    (0) disable-muted / (1) System default / (2) Custom sound specified by user
    default to 1 (System default)

  • toastSouvenir
    If you enabled the souvenir screenshot feature (see below)
    Display the souvenir screenshot inside the toast (Win10 only)
    (0) disable / (1) header (image crop) / (2) footer (image resized to fit)
    default to 0 (disable)

    header (image crop) footer (image resized to fit)

  • groupToast
    Group toast by game within the Action Center
    default to false

[notification_transport]

  • toast
    Use PowerShell to create a Windows 8-10 toast notification
    default to true

  • winRT
    Use WinRT API (if available) for faster toast instead of PowerShell
    default to true

  • balloon
    Fallback to balloon tooltip on toast notification failure
    default to true

  • websocket
    Broadcast achievement to all connected clients
    More info
    default to true

  • gntp
    Send a 'Growl' notification to gntp@localhost:23053
    More info
    default to true

[notification_advanced]

👮 Change these values only if you know what you are doing

  • timeTreshold
    Amount of sec an achievement is considered achieved from its timestamp value before being discarded
    default to 10 (sec)

  • checkIfProcessIsRunning
    When an achievement file is modified; Whether to check or not if the corresponding game's binary is running and responding
    If the game's binary is unknown then this check will be skipped
    This is mainly to mitigate false positive
    default to true

  • tick
    Ignore file modification within the specified time frame to prevent spam of notification when a game triggers multiple file write at the same time
    Set it to 0 to disable this feature
    default to 600 (ms)

  • iconPrefetch
    If set to false notification icon is passed as an url.
    It is the underlying transport system responsibility to handle the download / cache of said icon
    For example you can see information of notification assets cached by the Windows notification system in the registry under HKCU\Software\Microsoft\Windows\CurrentVersion\PushNotifications\wpnidm

    In some rare cases it can fail, time out, etc... resulting in a notification without any icon.

    To work around this you can set this option to true and watchdog will handle the download and cache by itself and will pass the file path instead of the url.

    Icons will be cached in %appdata%\Achievement Watcher\steam_cache\icon\[appid]

    When this option is set to true there will be an additional context menu 'Build icon notification cache' available in Achievement Watcher. Use this if you would like to download every game's icons beforehand.

    default to true

  • appID
    If not set, default to Xbox Game Bar if available otherwise to Xbox App
    Notification appID (Application User Model ID)
    Example:

    Name AppID
    Xbox Game Bar Microsoft.XboxGamingOverlay_8wekyb3d8bbwe!App
    Xbox App Microsoft.XboxApp_8wekyb3d8bbwe!Microsoft.XboxApp
    Xbox App (Win 8) microsoft.XboxLIVEGames_8wekyb3d8bbwe!Microsoft.XboxLIVEGames

    ⚠️ You need to use a UWP AppID otherwise you won't be able to remotely load img (url); Unless you are using iconPrefetch = true

    Watchdog is by default using Xbox AppID(s) for three main reasons :

    • They are pre-shipped with Windows
    • They are pre-set to your focus assistant priority list
    • They are UWP app so we are allowed to remotely load img (url)

[souvenir_screenshot]

  • screenshot
    Take a screenshot when you unlock an achievement
    default to true

  • custom_dir
    Save location.
    default to "" which equals to home folder "Pictures\[Game Name]\[Achievement Name].png"

  • overwrite_image
    Overwrite existing file
    default to false

[souvenir_video]

  • video
    Record a short video when you unlock an achievement using the hardware encoder of your GPU (= low performance hit)
    This feature requires NVIDIA or AMD GPU with hardware-accelerated encoding capabilities
    (0) disable / (1) NVIDIA (NVENC) / (2) AMD (AMF)
    default to 0 (disable)

  • codec
    Video codec to use. (0) H.264/AVC / (1) H.265/HEVC
    💡 Audio codec is AAC
    default to 0 (H.264/AVC)

  • colorDepth10bits
    H.265/HEVC : use 8bits (false) or 10bits (true) color depth
    default to false

  • custom_dir
    Save location
    default to "" which equals to home folder "Videos\[Game Name]\[Achievement Name].mp4"

  • overwrite_video
    Overwrite existing file
    default to false

  • duration

    • 10 (sec)
    • 15 (sec)
    • 20 (sec)
    • 30 (sec)
    • 45 (sec)

    default to 20

  • framerate
    Frame per second (target input and target output)
    30 (fps) or 60 (fps)
    default to 60

  • cursor
    Capture mouse cursor or not
    default to false

[action]

  • target
    Process to spawn (full path !) when you unlock an achievement. This can be a script (.bat, .cmd, .ps1, ...), a binary, whatever you want really. Achievement data will be exposed to the child process using env var as follow:
AW_APPID: unique game identifier
AW_GAME: game name
AW_ACHIEVEMENT: achievement id (api name)
AW_DISPLAYNAME: achievement title
AW_DESCRIPTION: achievement description (if any)
AW_ICON: unlocked icon url
AW_TIME: unix timestamp

  • cwd
    Current working dir for the child process (default to the parent dir of the target path).

  • hide
    Whether to spawn the child silently (no window) or not (default to true).

Clone this wiki locally