X Tutup
Skip to content

Home

Jump to bottom
Steam Achievement Notifier edited this page Jan 9, 2026 · 34 revisions

Welcome to the Steam Achievement Notifier Wiki!

See below for help with common issues, frequently asked questions and in-depth information on settings and features.

💡 Help
 ⚠️ Steam says the game is still running after it has closed

Steam Achievement Notifier needs to "release" data for the current game to allow Steam to quit the game correctly. To do this, it needs to know what executable (EXE) runs the current game.

💭 Why does Steam Achievement Notifier need to know the game's EXE?

Steam Achievement Notifier needs to know the location of each game's EXE in order to track its status - i.e. whether it is still running or closed.

ℹ️ EXEs are usually found automatically for each game, but as launch methods vary greatly between games on Steam, EXEs sometimes cannot be found automatically for certain games.

While Steam Achievement Notifier is tracking a game, Steam essentially sees it as another "instance" of the same game. So, if Steam Achievement Notifier cannot check the status of the actual game's EXE, it doesn't know when the game is closed in order to "release" itself.

In this scenario, as Steam still sees Steam Achievement Notifier's instance of the game is open, it is unable to reset the game's status from "Playing" to "Closed" - causing Steam to think the game is still running.

When encountering this issue, there are multiple options:

ℹ️ For more information on Auto-Release Games, see Settings & Features > Settings > Games > Auto-Release Games

1. Add Auto-Release Game entry via window focus

  • If the Game EXE not found! notification appears when launching a game, click the notification to open an in-app dialog
  • Additionally, a similar dialog can be opened via the System Tray icon > right-click > Auto-Release Game (only available when a game is detected)
    • Within this dialog, the current game can automatically be added to Settings > Games > Auto-Release Games by doing the following:
      • Click the Add button
      • A 5-second timer will start counting down
      • Within these 5 seconds, focus the target game window
      • Once the timer completes, a new Auto-Release Games entry will be added for the current game

2. Add Auto-Release Game entry manually

  • Go to Settings > Games > Auto-Release Games
  • Click New...
  • Add the game's AppID and expected EXE file
  • Click Add to create a new entry for the game

3. Release the game manually

  • Go to the System Tray icon > right-click > Options > Release Game
  • (Optional) An in-app dialog may appear to confirm release

After completing any one of the above steps, Steam should no longer report the game as "Playing" after the game window closes.

 ⚠️ Unlock sound can be heard, but notification cannot be seen, or notification only appears when tabbing out

If the game uses DirectX 9/10/11*, ensure your in-game display setting is set to Borderless/Borderless Windowed (not Fullscreen). Any application external to a Fullscreen game cannot display content above it*.

ℹ️ *If the game uses DirectX 12, setting the in-game display mode to Fullscreen (but not Exclusive Fullscreen) should allow content to show above the game window, due to differences in the DX12 API vs previous versions. However, this may vary on a per-game basis, depending on implementation.

⚠️ If the game uses Vulkan/OpenGL, any other external application will not be able to display content above it*, even when set to Borderless/Borderless Windowed in-game. However, some games give the option of using a different graphics API (such as DirectX 12) instead.

ℹ️ *As a workaround, converting a windowed game to Borderless using applications such as Borderless Gaming will then allow games running under Vulkan/OpenGL to display content above the game window as normal.

 ⚠️ Notification stutters during animation

If your GPU is under heavy load while running games, try enabling Settings > OS > Disable Hardware Acceleration. This will move any animation processing from the GPU to the CPU, which may help with visual stuttering.

Otherwise, if you have used the Customiser to customise achievement notifications, ensure any external assets (such as background images, icons, notification sounds etc.) are of a reasonable file size. Loading high-quality assets requires a large amount of background processing, which can cause notification animations to stutter.

Additionally, enabling lots of in-app features simultaneously will require more processing. If your system is already consuming many of the available resources by playing a game, this will impact Steam Achievement Notifier's ability to both efficiently perform background tasks and display on-screen elements without compromise.

 ⚠️ Notification is delayed

If the game is currently in Early Access on Steam, there have been several reports that achievement unlocks appear to be significantly delayed via Steamworks. As this would indicate a Steam-related issue, there is little that can be done to mitigate this - other than waiting until the game is fully released on Steam, which appears to solve the issue.

Otherwise, if you have used the Customiser to customise achievement notifications, ensure any external assets (such as background images, icons, notification sounds etc.) are of a reasonable file size. Loading high-quality assets requires a large amount of background processing, which can cause notification animations to be delayed.

Additionally, enabling lots of in-app features simultaneously will require more processing. If your system is already consuming many of the available resources by playing a game, this will impact Steam Achievement Notifier's ability to both efficiently perform background tasks and display on-screen elements without compromise.

 ⚠️ Notification background is not transparent

If you have an NVIDIA graphics card:

  • Disable G-Sync if enabled
  • If you have changed any transparency-related settings within the NVIDIA Control Panel, try resetting them to default
  • Alternatively, setting all NVIDIA Control Panel settings to default appears to resolve this for some users

Otherwise, try deleting Steam Achievement Notifier's GPU cache:

  • Close Steam Achievement Notifier if it is open (via System Tray icon > right-click > Exit)
  • Open the Start menu
  • Type %appdata% and press Enter
  • In the window that appears, find the steamachievementnotifierv1.9 folder and delete it
  • Launch Steam Achievement Notifier again
 ⚠️ Stream Notifications background is not transparent in OBS

ℹ️ For more information on Stream Notifications, see the Settings & Features section

To resolve this issue, first ensure you are using the latest version of OBS, as older versions may not support transparency when capturing windows.

Then, ensure you are using Capture Method: Windows 10 (1903 and up). Other Capture Methods can introduce a non-transparent background when capturing windows.

 ⚠️ Tracking notification spawns repeatedly

When encountering this issue, try running Steam Achievement Notifier (V1.9) as Administrator:

  • Open the Start Menu
  • Type Steam Achievement Notifier (V1.9)
  • Right-click
  • Select Run as Administrator

If running as Administrator still does not resolve the issue, try enabling Settings > Advanced > Alt. Process Mode.

 ⚠️ Tracking notification reappears after the game closes

When a game is closed, if No Game Detected is initially displayed in the Game Display box (along with the System Tray icon displaying a red dot), but the Now Tracking notification spawns again soon afterwards, this would indicate that Steam is taking longer than usual to reset the status of the current game.

To fix this, increase the value of Settings > Advanced > Release Delay.

ℹ️ This will ensure Steam Achievement Notifier waits the specified number of seconds before attempting to track the next game - therefore allowing Steam additional time to reset the status of the current game.

 ⚠️ "No Game Detected" displayed when a Steam game is currently running

Open Settings > App Log, then change the dropdown to rust.log.

If there is an error stating Failed to execute "GetCimInstance" command: Error { kind: NotFound, message: "program not found" }, this means Windows does not have an environmental variable set for Powershell.

In order to fix this issue, add a new environmental variable entry for Powershell on the system:

  1. Type env into the Start Menu
  2. When it appears, click Edit the system environment variables
  3. Once the window opens, click the Environmental variables... button
  4. Under the System Variables section at the bottom of the window that appears, select the Path entry
  5. Click the Edit... button
  6. Another window will appear. Click the New button, which will create an empty text field
  7. Paste the following text into the text field: %SYSTEMROOT%\System32\WindowsPowerShell\v1.0\
  8. Click the OK button* on all opened windows to save the new environmental variable

⚠️ * Ensure only OK is clicked, not Cancel - cancelling any of these windows will also cancel your changes!

  1. Exit the app via System Tray > Options > Exit, then relaunch. Games should now be detected as normal!

If any other errors are appearing in san.log/rust.log/sanhelper.log, please report the issue via GitHub or Discord.

If the above does not solve the issue, you may be missing the Latest Microsoft Visual C++ Redistributable (VCRUNTIME140.dll) on your system, as advised in this GitHub Issue.

ℹ️ To install, click the above link, then try installing both the x86 and x64 versions. Once complete, restart the application and re-test.

 ⚠️ Achievement titles/descriptions are shown in English when Steam is set to use a different language

Try manually specifying the Language setting for the current game:

  • Open Steam > Library
  • Right-click the game > Properties
  • On the General tab (selected by default), select your desired language from the Language dropdown menu

Alternatively, enable the Settings > Language > Translate Achievements to Steam Language setting. Enabling this setting will attempt to load locally-stored translations for achievements in the user's chosen Steam UI language.

ℹ️ This may also be caused by adding a game to the Library while Steam's language is set to English

📢 FAQs
 💭 How do I disable native Steam achievement notifications?

Steam allows notifications to be globally* disabled via Settings > Notifications > Show Notification Toasts... > Never.

steamnonotifications

⚠️ *Changing this setting to Never will disable all Steam notification types - including achievements, Friends & Chat messages, online statuses etc. This is how Valve have chosen to implement the notification system on their platform, so this is not something that is able to be changed or customised by users!

 💭 Are other non-Steam launchers supported?

🚫 TLDR; No, only Steam is supported at this time.

Other game launchers - such as Epic Games, EA Play, Origin, Rockstar, Xbox, Playstation etc. - do not provide a way to access any user's platform stats - game-related or otherwise.

The reason we are able to access user/game stats on Steam is due to Valve explicitly creating and providing publicly-available APIs - i.e. Steamworks/Steam Web API - precisely for this purpose.

ℹ️ This is why there are so many sites dedicated to displaying Steam platform/game data, and relatively very few (if any) sites regarding data on any of the other launcher platforms. Because Valve allows users safe and efficient access to this data, it is utilised in many more places!

Other launchers do not provide anything close to this, so the kind of data we can get for users/games on other platforms is either, at best, very limited, or non-existent.

Additionally, other platforms usually also contain their own achievement ecosystems - including notifications.

 💭 Why do notifications not show over games set to Fullscreen mode?

When your in-game video settings are set to Fullscreen mode, the game is rendered in a DirectX* window.

When a game is rendered this way, DirectX "owns" the screen - i.e. nothing can be shown above it, as this window replaces the usual desktop display methods.

ℹ️ The switch from desktop to DirectX is usually visible - the whole screen will turn black momentarily while DirectX takes over.

Borderless windows are exactly as described - a maximised window without borders, which allow other windows to be shown above them.

Steam Achievement Notifier works by spawning an always-on-top window over your game. As above, games set to run in Fullscreen mode don't allow any other windows (such as notifications) to show over them - the notifications will appear if you switch to your desktop, but will not appear in-game.

This is why you need to set your game to Borderless when using Steam Achievement Notifier.

ℹ️ *Also applicable to Vulkan/OpenGL graphics APIs.

 💭 Will showing notifications in Fullscreen mode ever be supported?

🚫 TDLR; Not currently due to potential anti-cheat risks and games moving away from "true" fullscreen

ℹ️ If your game supports and is run in DirectX 12, notifications might be able to show above windows set to Fullscreen mode (depending on the implementation and available in-game display options). However, anything earlier than DX12 - e.g. DX11/DX9/Vulkan/OpenGL - will not.

Using Electron, there are ways to enable notifications to show within games set to Fullscreen mode.

However, due to the nature of Fullscreen graphics APIs, the only way to allow any other external window - such as a notification - to appear within a game is to "inject" code into the game window itself - i.e. create a texture within the game that mimics the content of the window you want to display.

This process is extremely complex, but the complexity is greatly reduced by using external libraries to carry out this "injection" process on behalf of another application.

By now, though, you have probably realised that modern games - especially those that utilise anti-cheat software - would likely look upon any attempt to "inject" external code into a game very unfavourably, to say the least. Whether injecting code into a game provides an in-game advantage to the player or not, running external software to do this kind of thing - no matter how innocent the reason behind it may be - could result in bad things happening to the user's account(s).

For this reason, I'm not overly keen to pursue this avenue of development unless there is a guaranteed way to ensure the safety of any user's account(s).

Additionally, modern games are widely adopting newer graphics APIs - namely DirectX 12 - which usually allows external content to be displayed on top of the game window in Fullscreen mode. As a result, the number of development hours needed to implement a "true" Fullscreen solution would not, in my opinion, be worth the effort solely to add support for old games, when there are plenty of free, safe and easy-to-use tools available that can work around these historic limitations.

 💭 Will using Steam Achievement Notifier affect my Steam account?

🚫 TLDR; No, using Steam Achievement Notifier will not affect your Steam account!

Steam Achievement Notifier has no access to your Steam account, other than your achievement stats - these are accessed using internal Steam client data made available via the use of the Steamworks API.

Using Steamworks to get information about a user's stats is a method provided by Valve themselves, and there is no risk to user accounts by utilizing it!

ℹ️ Steam Achievement Notifier cannot and will not ever carry out any action within Steam on behalf of the user - such as access your Steam account, message friends or make friend requests, initiate or accept trades, buy anything from the Store, access or store personal info, Steam points or saved payment information etc.

 💭 Where are Steam Achievement Notifier's files stored on my PC?

All Steam Achievement Notifier (V1.9) app-generated files are extracted to a few different locations on your system, depending on your OS:

1. Installation Directory

The application is installed/extracted to the following directory:

  • Windows: C:/Users/%username%/AppData/Local/Programs/steamachievementnotifierv1.9
  • Linux*: ~/tmp/.mount_Steam (*Extracted from portable AppImage - Only visible while app is running)

ℹ️ On Windows, the uninstaller is also located here.

2. Application Data Files

This directory stores core files used by the application, such as:

  • config.json: Steam Achievement Notifier's main configuration file,
  • customfiles: The directory from which Use Custom App Files loads data

Core files are installed in the following directory:

  • Windows: C:/Users/%username%/AppData/Local/Steam Achievement Notifier (V1.9)
  • Linux: ~/.local/share/Steam Achievement Notifier (V1.9)

ℹ️ If not working correctly, you can close the app, and then either delete this directory, or rename it for backup (e.g. Steam Achievement Notifier (V1.9).old). The files will then be rebuilt from scratch on next launch!

3. Auto-Generated Electron Directory

This location contains files and folders created automatically by Electron:

  • Windows: C:/Users/%username%/AppData/Roaming/steamachievementnotifierv1.9
  • Linux: ~/.config/steamachievementnotifierv1.9

🏆 Settings & Features
 🏠 Home Screen
  • Game Display: The game for which achievements are currently being tracked. Displays No Game Detected while no game is running.

ℹ️ Only displays game information for Steam games. Emulated games will appear under Settings > RetroAchievements > Status Panel.

  • Theme Select: Select a previously saved Theme, or sync the current Theme across all notification types.

ℹ️ For more information, please see Settings & Features > Customiser > Themes.

  • Notification Type Tabs: Switch between notification types.

  • Customise: Open the Customiser menu to customise achievement notifications.

  • Show Test Notification: Show an on-screen Test Notification, including any customisations made via the Customiser menu.

 🖱️ System Tray
  • Game Display/Tracking Dot: The game for which achievements are currently being tracked. Displays No Game Detected while no game is running. Additionally, the Tracking Dot indicates the tracking status of the app:
🔴 No game is detected
🟢 Achievements for a game are actively being tracked
🟡 A game has been detected, but has no achievements

ℹ️ Only displays game information for Steam games. Emulated games will appear under Settings > RetroAchievements > Status Panel.

  • Options:

    • Reset Window: Reset the position of the app window to the center of the primary monitor.
    • Release Game: Manually release the current game if Steam says it is still running after being closed.
    • Suspend/Resume: Manually suspend/resume the background Worker process responsible for tracking achievements.
    • Restart App: Closes the app, then immediately re-opens it.

  • Auto-Release Game: Open the dialog to automatically add a new entry for the current game's AppID to Settings > Games > Auto-Release Games by focusing the window. Only visible when a Steam game is being tracked.

ℹ️ For more information, see Settings & Features > Settings > Games > Auto-Release Games.

  • Replay Notification: Replay the notification for the last unlocked achievement.

ℹ️ At least one achievement must be unlocked in the current session before this option can be used.

  • Exit: Closes the app. Steam Achievement Notifier will no longer run in the background once exited.
 ⚙ Settings
 🌐 Language

  • Language dropdown: Select the UI language used within the app.

  • Translate Achievements to Steam Language: Attempt to load translations located within Steam's application files to display achievement information in the user's chosen Steam client language.

ℹ️ This option attempts to locate translations in a JSON file stored within Steam's application data. If a translation for the current achievement cannot be located, achievement information retrieved from Steamworks will be displayed instead.

  • Max Translation Retries: The number of times (per 100ms) attempts to locate valid translations for the current achievement will be made.

ℹ️ Steam currently only stores a small amount of achievement data within each game's associated JSON file. Any achievements that are not present within this file will be appended after the achievement is unlocked.

As appending new data can take time, increasing this value will increase the likelihood that translation data for the current achievement will be located, but may also delay the notification from appearing on-screen by the amount of time calculated by this setting.

If no valid translation data can be located for the current achievement, translations will fallback to the language specified in Steamworks.

 🖥 OS

  • Create Desktop Shortcut: Toggle a shortcut on the Desktop to run the app.

  • Start at Login: Start Steam Achievement Notifier automatically after logging in.

  • Start Minimized: After launching, hide the app UI window until opened from the System Tray.

  • Disable Hardware Acceleration*: Disable Hardware Acceleration, which may improve performance on lower-end systems, or systems without a dedicated GPU.

ℹ️ *App will restart after enabling/disabling this option.

 🔔 Notifications

  • Trophy Mode: Replace Main/Rare/100% notification types with Bronze/Silver/Gold/Platinum.

  • Max Notifications: Set the maximum number of simultaneous on-screen notifications.

    • Notification Spacing: Set the distance between simultaneous on-screen notifications. Only visible when Max Notifications is enabled.

⚠️ Increasing the number of simultaneous on-screen notifications requires more resources and may result in reduced performance.

  • Rare Percentage: The percentage at which Rare achievement notifications will be triggered.

ℹ️ Any achievement with an unlock percentage above this value will be displayed as a Main notification.

If Trophy Mode is enabled, any achievement with an unlock percentage above this value will be displayed as a Silver notification instead.

  • Silver Percentage: The percentage at which Silver notification assets will be displayed (e.g. Rarity Badges, Decorations etc.).

ℹ️ Any achievement with an unlock percentage below (or equal to) this value, and above the value of Rare Percentage, will display notification assets configured for Silver rarities.

Any achievement with an unlock percentage above this value will display notification assets configured for Bronze rarities.

If Trophy Mode is enabled, any achievement with an unlock percentage above this value will be displayed as a Bronze notification instead.

  • Show Percentage: Display the unlock percentage of the achievement in the notification for the selected type(s).

  • Sound-Only Mode: Disable notifications, only playing sounds set via the Customiser.

  • Show Tracking Notification: Display a notification notifying the user that achievements for the detected game are being tracked.

    • Tracking Scale: Set the size of the tracking notification. Only visible when Show Tracking Notification is enabled.
    • Tracking Position: Set the position of the tracking notification. Only visible when Show Tracking Notification is enabled.

  • Disable Icon Caching: Disable caching achievement icons while launching games.

ℹ️ This can greatly improve in-app performance when launching games, and may also resolve tracking issues with games that have a large number of achievements. However, in rare instances, disabling icon caching may result in missing achievement icons in notifications.

  • Notification Shortcuts: Trigger a Test Notification via a keyboard shortcut. Shortcuts can be customised for each notification type.

  • Custom Trigger: Trigger a key/combo to be simulated when unlocking an achievement. Can be used to trigger keyboard shortcuts registered in external applications.

    • Trigger Shortcut: Trigger the specified key/combo when an achievement is unlocked. Supports between 1-3 keys per shortcut. For keypresses/combos requiring less than 3 keys, press the desired keys and wait for the timer (5s) to end.
    • Trigger Delay: Delay the specified key/combo by the number of seconds specified.
    • Use Display Time: Delay the specified key/combo based on the current notification type's Display Time value (set via the Customiser).

  • Post to Discord Server: Use a webhook URL to post in a Discord server whenever an achievement is unlocked.

    • Webhook Types: Toggle whether to post achievement information to a Discord server when a Main/Rare/100% achievement or Test Notification is unlocked.
    • Add Spoiler Tag: Add a spoiler tag to "Hidden" achievements when posted to Discord.
    • Show AppID: Show the Steam AppID of the current game in the footer of the webhook embed.
    • Webhook URL: Set the webhook URL for the desired Discord server.

ℹ️ A webhook URL is used to post to a Discord server/channel on behalf of a user or application. In order to set up a new webhook for a Discord server, the user must have a role within the desired server that allows the creation of webhooks.

A webhook URL is required when using this option.

Refer to Discord's official documentation for more information.

  • Replay Notification: Replay the notification for the last unlocked achievement.
    • Replay Shortcut: Replay the last achievement notification using the specified keyboard shortcut.

ℹ️ At least one Steam achievement must be unlocked in the current session before this option can be used.

 🎮 Games
  • Auto-Release Games: Bypass automatic process tracking for specific Steam games.

ℹ️ If Steam says the current game is still running after the game window has closed, add the affected game's Steam AppID, along with the EXE responsible for running the game, to Auto-Release Games. This tells Steam Achievement Notifier that whenever this AppID is detected, to only check the status of this EXE.

When the specified EXE is detected as closed, Steam Achievement Notifier will "release" the game - allowing Steam to close the game properly.

For further information, see 💡 Help > ⚠️ Steam says the game is still running after it has closed.

  • Auto-Switch Themes: Automatically switch to any saved Theme when a specific game is detected.

  • Exclusion List*: Prevent achievements in specific Steam games from being tracked by the app.

  • Inclusion List*: Prevent all Steam games from being tracked by the app unless specified.

    • List Mode: Set the behaviour of the Exclusion/Inclusion List.

ℹ️ *Click the List Mode button (located beside the Exclusion/Inclusion List button) to toggle between the two modes.

 📷 Media

  • Take Steam Screenshot: Take a Steam screenshot when an achievement is unlocked.

  • Additional Media > Screenshot with Notification Overlay: Overlay an image of the achievement notification on top of a screenshot when an achievement is unlocked.

    • Screenshot Mode: Set whether to capture the entire screen or the current game window* in screenshots. If the current game's EXE cannot be located (either via automatic process tracking or when added as an Auto-Release Games entry), this option will default to Screen mode.
    • Screenshot Source: The monitor that will be captured when taking the screenshot.
    • HDR Mode: Take screenshots using a method compatible with monitors using High Dynamic Range (HDR).
    • Enable: Enable or disable generating media for the selected notification type.
    • Overlay Position: The position of the notification overlay within the screenshot.
    • Match Customiser Position: Match the Screen Position set in the Customiser for the selected notification type.
    • Notification Elements*: Add or remove individual elements from the notification overlay within the screenshot, independent of the on-screen notification.
      • Match Customiser Settings: Match the Notification Elements settings set in the Customiser* for the selected notification type. *Some Notification Presets cannot fully match Customiser settings, due to differences between on-screen and screenshot-based notification layouts.
    • Horizontal Offset: Offset the notification displayed in the screenshot horizontally.
    • Vertical Offset: Offset the notification displayed in the screenshot vertically.
    • Screenshot Path: The location where screenshots generated by this option will be saved.
    • Screenshot Delay: Add a delay from when the notification occurs to when the screenshot is taken. Max: 10 seconds.
    • Preview: Show a preview of how the screenshot will appear when saved.

  • Additional Media > Notification Image: Export an image of the notification overlay without taking a screenshot.

    • Enable: Enable or disable generating media for the selected notification type.
    • Notification Elements*: Add or remove individual elements from the notification overlay within the screenshot, independent of the on-screen notification.
      • Match Customiser Settings: Match the Notification Elements settings set in the Customiser* for the selected notification type. *Some Notification Presets cannot fully match Customiser settings, due to differences between on-screen and screenshot-based notification layouts.
    • Image Path: The location where notification images generated by this option will be saved.
    • Preview: Show a preview of how the notification image will appear when saved.

ℹ️ *For more information, see Settings & Features > Customiser > Preset > Notification Elements.

 📹 Streaming

  • Audio Source: Select the source of (or disable) audio generated by the app.

    • Notification: Sound is triggered via the on-screen notification. Audio source cannot be targeted by streaming software, such as OBS, as notification windows are destroyed after completing animation in order to free system resources.
    • App Window: Sound is triggered via the app window. This allows streaming software, such as OBS, to target the window as a persistent audio source.
    • Muted: No sound will be played when a notification is spawned.

  • Stream Notifications: Create a window that duplicates any notifications currently being displayed on-screen. This window can then be added as a Window Capture source for use in streaming software, such as OBS.

    • Show Window: Toggle visibility of the Stream Notifications window. When enabled, once a notification is triggered, both the on-screen notification and the Stream Notification will be visible on-screen. When focused in the taskbar, press and hold the Ctrl key to display the current location of the window in order to reposition it. Only visible when Stream Notifications is enabled.
    • Frame Rate: Set the target frame rate for Stream Notifications. Only visible when Stream Notifications is enabled.

  • Achievement Stats Overlay: Display configurable achievement stats for the current game in an external window.

    • Always On Top: Set the Achievement Stats Overlay to "Always on Top" mode, allowing the window to be displayed above the game window. When enabled, the Achievement Stats Overlay will no longer register user interactions, such as "click" events. To re-enable interaction with the window, this option must be disabled. Only visible when Achievement Stats Overlay is enabled.

  • Overlay Shortcut: Toggle the Achievement Stats Overlay using the specified keyboard shortcut.

  ♿ Accessibility

  • Disable App Window Animations: Disable all in-app window animations and transition effects.

  • Disable Update Dialog: Prevent the Update Available dialog from showing and focusing automatically. The dialog can still be accessed by clicking the update button when available.

  • Enable NVDA Support: Enable copying achievement information to the clipboard when an achievement is unlocked, in order to be read by screen-reader software, such as NVDA.

  • Show Tooltips: Display tooltips when hovering over certain UI elements.

  • Show System Tray Options: Display all options usually located under System Tray > Options in Settings > Misc.

  • Release Game Shortcut: Release the currently tracked game using the specified keyboard shortcut.

 🔧 Advanced
  • Poll Rate: Set the update interval for achievement data during gameplay.

ℹ️ Performance may increase/decrease depending on the value or system hardware. Higher values typically result in lower system load, but may cause notifications to be more delayed.

  • Tracking Delay: Set the delay between detection of the current Steam AppID and when process/achievement tracking starts.

ℹ️ Increasing this value can prevent scenarios where Steam is unable to launch the current game, due to the app initialising Steamworks before the game has launched.

Alternatively, increasing this value can also be used to bypass incorrect detection of pre-game launcher processes.

  • Release Delay: Set how long the background Worker process waits to restart after the current game has been released. Affects both automatic process tracking and Auto-Release Games.

ℹ️ Allows a longer timeframe for Steam to reset the RunningAppID Registry value. Increasing this value can prevent unusual behaviour, such as tracking a previously closed game.

  • Max Process Retries: Set the maximum number of retries to link a running process to a detected AppID. Affects both automatic process tracking and Auto-Release Games.

ℹ️ Retries are attempted once every second. If a running process is not linked to the current Steam AppID after this number of retries, an invalid process will be returned. In such cases, the game will need to be manually released via System Tray > Options > Release Game, or via the Release Game Shortcut.

  • Alt. Process Mode: Use an alternative Rust-based function to check whether tracked game processes are currently running on the system. When unchecked, the default Node JS-based process check will be used instead.

  • Debug Panel: Open the Debug Panel, which displays in-depth process tracking information.

  • Show Notification DevTools: Create a DevTools window for all notifications. Useful for debugging/troubleshooting notification issues.

  • Export Achievement Data: Export achievement data to a JSON file when an achievement is unlocked.

ℹ️ When enabled, achdata.json will be exported to:

  • Windows: C:/Users/%username%/AppData/Local/Steam Achievement Notifier (V1.9)
  • Linux: ~/.local/share/Steam Achievement Notifier (V1.9)
  • Previous Log Files: The number of previous log files stored before deletion. A new log file will be generated upon each app launch.

ℹ️ When set to 0, all previous log files will be deleted upon exit.

  • Audio Cooldown: Set the amount of time subsequent notifications wait before new audio can be played.

ℹ️ Audio will be unaffected if Settings > Notifications > Max Notifications is set to 1.

  • Use Custom App Files: Enables notifications to load user-customisable files.
    • Show Custom App Files: Open the directory where user-customisable files are stored and loaded.

⚠️ Caution is advised for regular users - editing notification files requires prior knowledge of HTML/CSS/JS.

ℹ️ Customiser > Themes > Import/Export Theme will be disabled when Use Custom App Files is enabled.

 🕹 RetroAchievements

  • Username: Set the RetroAchievements username to track achievements for.

  • API Key: Set the Web API Key to use for authentication to the RetroAchievements API.

ℹ️ A Web API Key can be copied or regenerated by logging into the RetroAchievements website and navigating to Settings > Keys > Web API Key.

🔒 The provided key will be encrypted before being stored locally on the system (if the current OS supports encryption).

  • Emulators: Enable tracking games for the selected emulators.

    • Log File Path: Set the path to each selected emulator's log file.

  • Status Panel: Displays information about emulated games currently being tracked via events written to the emulator's log file.

    • Status: The last status event written to the game's log file.
    • Game: The name of the emulated game being current being tracked. If no game is detected, a - symbol will be displayed.
    • Last Ach. ID: The ID of the last unlocked RetroAchievements achievement. The ID of the last unlocked achievement is always stored to prevent scenarios where notifications can infinitely spawn.
    • 🚫: Reset the Last Ach. ID value back to 0.

ℹ️ See RA.md for information regarding supported emulators and setup guides.

 ⚙ Misc.
  • Color Profile*: Force all app windows to render using the selected color profile.

ℹ️ *App will restart on change.

  • Check For Updates: Check whether a new app version has been released on GitHub. If an update is available, it will be automatically downloaded and installed once confirmed via the Update Available dialog.

  • App Log: Open the App Log window, which displays information about process activity, warnings and errors.

    • Log Type dropdown: Select which log file to view. Any existing previous log files can also be selected.
    • Copy Log Contents: Copy all contents of the log file to the clipboard for sharing.

  • Reset App: Removes all configuration data and restarts the app.

🛑 ALL existing app data - including Settings, Customiser settings, Themes and user-customised app files - will be permanently deleted once confirmed!

 🎨 Customiser
 🗃 Preset

  • Notification Preset: Select a notification preset to customise.

  • Notification Elements: Show, hide or reorder each element within the selected Notification Preset.

    • Show Screenshot Preview: Display a preview of the captured screenshot within the notification. Only visible when Settings > Media > Additional Media > Screenshot with Notification Overlay is selected.
    • Unlock Message: Set the position of the unlock message/custom text within the notification.
    • Title: Set the position of the achievement title within the notification.
    • Description: Set the position of the achievement description within the notification.
    • Rarity Percentage: Set the position of the unlock percentage within the notification. Only visible when Settings > Notifications > Show Percentage is not set to Off and Customiser > Preset > Notification Elements > Rarity Badge is not enabled.
    • Hidden Icon: Set the position of the hidden/secret achievement icon within the notification. Only visible when Customiser > Icons > Show Hidden Icon is enabled.
    • Decoration: Set the position of the decoration element within the notification. Only visible when certain Notification Preset options are selected.
    • Rarity Badge: Display the unlock percentage inside a badge placed above the achievement/game icon.
      • Badge Position: Set the position of the badge.
      • Badge Color: Set the background color of the badge.
      • Badge Font Color: Set the font color of the badge.
      • Badge Size: Set the size of the badge.
      • Badge Roundness: Set the roundness of the badge.
      • Horizontal Offset: Offset the position of the badge element horizontally.
      • Vertical Offset: Offset the position of the badge element vertically.
      • Use Icon: Display a rarity-based icon as the badge element.
        • Reset Badge Icons: Reset all badge icons to default.

  • Display Time: Set the number of seconds the notification will display.

  • Scale: Increase or decrease the size of the notification.

  • Custom Text*: Set a custom message to be displayed within the notification. Enabling this option replaces the default Achievement unlocked message.

    • Use Game Title*: Show the title of the current game within the notification. Enabling this option replaces both the the default Achievement unlocked message and any message added via Custom Text.

ℹ️ *Only visible when Customiser > Preset > Notification Elements > Unlock Message is not hidden for the selected Notification Preset.

  • Custom Font*: Load a custom font to be used within the notification.

ℹ️ *Only .ttf/.otf/.woff/woff2 font formats are supported.

 🎵 Sound

  • Sound Mode: Select either a single audio file, or a randomly selected audio file from within a folder containing multiple audio files, when a notification occurs.

    • Sound File: Select an audio file to play when a notification occurs.
    • Sound Folder: Select a folder from which an audio file will be randomly selected when a notification occurs.

  • Volume: Set the playback volume of the audio file.

  • Preview: Preview the selected audio file, or an audio file randomly selected from the folder.

 🖌 Style

  • Background Style: Select the style for the background of the notification.

    • Solid: A single color. Set via Customiser > Colors > Primary Color.
    • Gradient: A two-color gradient effect. Set via Customiser > Colors > Primary Color/Secondary Color.
      • Gradient Angle: Set the angle of the gradient.
    • Background Image: A user-defined image file.
      • Background Image: Load an image file to be used as the notification background.
      • Brightness: Set the brightness of the image used as the notification background.
      • Blur: Set the level of blur applied to the background of the notification.
    • Game Art: Game-specific art located within <Steam installation directory>/appcache/librarycache.
      • Brightness: Set the brightness of the game art used as the notification background.
      • Blur: Set the level of blur applied to the background of the notification.

  • Roundness: Set the roundness of the notification edges.

  • Font Size: Set the size of the font used in the notification.

    • Use Custom Font Sizes*: Individually increase or decrease the size of text elements within the notification.
      • Unlock Message: Increase or decrease the size of the unlock message text element.
      • Title: Increase or decrease the size of the achievement title text element.
      • Description: Increase or decrease the size of the achievement description text element.

ℹ️ *Preservation of the intended notification layout cannot be guaranteed when changing individual font size values.

  • Text Spacing: Adjust the vertical spacing between text elements within the notification.

  • Opacity: Set the overall opacity of the notification.

    • Background Only: Only set the opacity for the notification background, keeping other elements at full opacity. Only able to be changed when Opacity is set to < 100%.

  • Outline: Display an outline around the notification.

    • Outline Type: Select the type of outline to show around the notification.
      • Solid: A solid outline.
      • Dashed: A dashed outline.
      • Dotted: A dotted outline.
    • Outline Color: Set the color of the outline around the notification.
    • Outline Width: Set the width of the outline around the notification.

  • Glow: Enable a glow effect that surrounds the notification.

    • Size: Set the size of the glow effect.
    • Horizontal Offset: Offset the position of the glow effect horizontally.
    • Vertical Offset: Offset the position of the glow effect vertically.
    • Color: Set the color of the glow effect.
      • Use Rarity: Change the color of the glow effect based on the rarity of the unlocked achievement.
    • Animation: Select a preset animation to be applied to the glow effect.
      • Speed: Set the speed of the animation applied to the glow effect.

  • Mask: Enable masking parts of the notification with a custom image.

    • Mask Image*: Load an image file to be used as the mask.

ℹ️ *In CSS, mask-mode: alpha operates in the opposite way to what is usually expected - areas of transparency in the image file will be obscured, and areas of black/grey will allow the elements below to be visible.

 🎨 Colors

  • Primary Color: Set the primary color of the notification.

  • Secondary Color: Set the secondary color of the notification.

  • Tertiary Color: Set the tertiary color of the notification. Only visible when certain Notification Preset options are selected.

  • Font Color: Set the color of all text displayed within the notification.

  • Use Custom Font Colors: Individually set the color of text elements within the notification.

    • Color 1*: Set the color of the first text element.
    • Color 2*: Set the color of the second text element.
    • Color 3*: Set the color of the third text element.

ℹ️ *Applied font colors are dependent on the element order specified in Customiser > Preset > Notification Elements.

  • Font Outline: Add an outline to all text displayed within the notification.

    • Font Outline Color: Set the color of the text outline.
    • Font Outline Scale: Set the thickness of the text outline.

  • Font Shadow: Add a shadow to all text displayed within the notification.

    • Font Outline Color: Set the color of the text shadow.
    • Font Outline Scale: Set the thickness of the text shadow.
 🔣 Icons

  • Icon Scale: Increase or decrease the size of the achievement/game icon displayed within the notification.

  • Icon Roundness: Set the roundness of the achievement/game icon displayed within the notification.

  • Use Game Icon: Replace the icon of the unlocked achievement with the icon for the current game.

    • Game Icon Type: Select which type of image to display as the Game Icon.
      • Icon: The standard Library icon used for each Steam game.
      • Logo: A separate Logo icon, usually displaying the game name as stylised text.

  • Use Custom Icon: Replace the icon of the unlocked achievement with a custom image file.

    • Custom Icon: Load an image file to be used as the Custom Icon.

  • Show Icon Border: Display an image as a border around the achievement icon.

    • Icon Border: Load an image file for use as a border around the achievement icon.
    • Use Rarity: Change the displayed icon border image based on the rarity of the unlocked achievement.
    • Border Position: Set whether to display the icon border image in front or behind the achievement icon.
    • Border Scale: Increase or decrease the size of the icon border within the notification.
    • Horizontal Offset: Increase or decrease the horizontal offset of the icon border within the notification.
    • Vertical Offset: Increase or decrease the vertical offset of the icon border within the notification.

  • Show Hidden Icon: Display an image indicating the achievement is a hidden/secret achievement in the notification.

    • Hidden Icon: Load an image file to replace the hidden/secret achievement icon.
    • Eye icon: Toggle the visibility of the Hidden Icon element in Customiser previews and Test Notifications.

  • Logo*: Load an image file to replace the Logo icon.

    • Logo Scale: Increase or decrease the size of the Logo element within the notification.

  • Decoration*: Load an image file to replace the Decoration icon.

    • Decoration Scale: Increase or decrease the size of the Decoration element within the notification.
    • Replace Logo: Replace the Logo icon in the notification with the selected Decoration.

ℹ️ *Logo/Decoration options are only visible on Notification Presets that display each element.

 🎯 Position

  • Screen Position: Set the on-screen position of the notification.

  • Use Custom Position: Enable custom positioning for the notification.

    • Set: Set the custom position for the notification.
    • Apply to All: Apply the custom position to all other notification types.
    • Reset: Reset the position of the notification to the default custom position.
 ✨ Theme

  • Update Theme: Update the current Theme with the selected customisation options.

  • Save Theme: Save all configured customisation options as a new Theme.

  • Import Theme*: Import customisations via a user-created Theme file.

  • Export Theme*: Export the currently selected Theme for sharing.

⚠️ Before attempting to export, please ensure the desired Theme has been selected either via the Home Screen > Theme Select menu or via Customiser > Selected Theme.

🛑 Please also ensure that customisations have been saved to the selected Theme via Save Theme. Any customisations not yet saved to the selected Theme will not be exported!

ℹ️ *Due to the ability to change the contents of core notification files, Import/Export Theme will be disabled when Settings > Advanced > Use Custom App Files is enabled.

Clone this wiki locally
X Tutup