import CopyableFAQ from '@docs/components/content/CopyableFAQ';
import { faqData } from './faqData';
import ReactMarkdown from 'react-markdown';
import { Accordions } from 'fumadocs-ui/components/accordion';
Frequently Asked Questions [#frequently-asked-questions]
{(() => {
const sections = [];
let currentFaqs = [];
let currentSection = null;
faqData.forEach((faq, i) => {
if ('section' in faq) {
if (currentFaqs.length > 0) {
sections.push(
{currentFaqs}
);
currentFaqs = [];
}
sections.push(
{faq.section}
);
currentSection = faq.section;
} else {
currentFaqs.push(
{faq.markdown.split('\n').slice(1).join('\n')}
);
}
});
if (currentFaqs.length > 0) {
sections.push(
{currentFaqs}
);
}
return sections;
})()}
import Cards from '@docs/components/content/Cards';
import CardLink from '@docs/components/content/CardLink';
import { FaSteam, FaImages, FaAward, FaTools, FaSignInAlt, FaQuoteRight, FaQuestion } from 'react-icons/fa';
import { GrInstallOption } from 'react-icons/gr';
import { TbCardsFilled, TbGift, TbClock, TbBuildingStore, TbHourglassLow } from 'react-icons/tb';
import { IoPlay } from 'react-icons/io5';
Get Started [#get-started]
Guides [#guides]
Miscellaneous [#miscellaneous]
import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { FaCheck, FaXmark } from 'react-icons/fa6';
export const Yes = () =>
export const No = () =>
What is Steam Game Idler PRO? [#what-is-steam-game-idler-pro]
First and foremost, Steam Game Idler is completely free to use, and always will be. All of the core features of SGI are available to all users at no cost.
Steam Game Idler **PRO** is an optional way to support the development of SGI. To thank you for your support, **PRO** subscribers receive a range of additional benefits that enhance the SGI experience.
There are two subscription tiers available — **Casual** and **Gamer** — each unlocking a different set of benefits.
By subscribing to **PRO**, you help with the ongoing development and maintenance of SGI, ensuring that it continues to improve and evolve over time.
| Feature | Casual ($2/mo) | Gamer ($4/mo) |
| ------------------------------ | :------------: | :-----------: |
| Ad-free experience | | |
| Exclusive themes | | |
| Unique Discord chat role | | |
| Automated Steam credentials | | |
| Automated games list updates | | |
| Automated free game redemption | | |
| Sell duplicate inventory items | | |
\* Prices are in USD and exclude taxes. Billed monthly, cancel anytime.
FAQ [#faq]
Open Steam Game Idler
Click the "**Go PRO**" badge in the app's title bar
Select your desired subscription tier *(Casual or Gamer)*
Click the "**Get Started**" button
Follow the prompts to complete your purchase through the secure payment gateway
Open Steam Game Idler
Click "**Settings**" in the sidebar
Navigate to the "**General**" tab
Click the "**Manage PRO Subscription**" button
Follow the prompts to confirm your cancellation
After cancellation, you will retain access to **PRO** benefits until the end of your current billing cycle.
To switch between **PRO** tiers, simply cancel your current subscription and subscribe to your desired tier following the standard subscription process.
After subscribing to Steam Game Idler **PRO**, you will receive an email receipt for your purchase. To view your billing history and upcoming invoices:
Open Steam Game Idler
Click "**Settings**" in the sidebar
Navigate to the "**General**" tab
Click the "**Manage PRO Subscription**" button
Follow the prompts to view your billing history and invoices
As **PRO** subscriptions are a donation rather than a normal subscription service, they are generally non-refundable. However, refunds can be considered on a case-by-case basis.
If there was a mistake, unexpected charge, or issue with your subscription, please use the in-app help desk to contact support or send an email to [contact@steamgameidler.com](mailto:contact@steamgameidler.com).
Chargebacks are when a payment made on your credit card or bank account is reversed, typically when the customer disputes a charge or claims it was unauthorized.
Steam Game Idler is a small independent project, and fraudulent chargebacks have a significant negative impact.
If a chargeback is filed on your **PRO** subscription without prior communication, your access to Steam Game Idler and all of its features may be revoked permanently.
If you believe a charge was made to your account in error, please contact support via the in-app help desk or send an email to [contact@steamgameidler.com](mailto:contact@steamgameidler.com).
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
Steam Credentials [#steam-credentials]
SGI needs your Steam credentials for the [Card Farming](/docs/features/card-farming) and [Inventory Manager](/docs/features/inventory-manager) features.
Steam credentials are used to verify which of your games have card drops remaining, as well as fetching and listing your inventory items on the Steam market.
SGI offers both a [**Manual Method**](/docs/steam-credentials#manual-method) and an [**Automated Method (PRO)**](/docs/steam-credentials#automated-method) for providing your Steam credentials.
These credentials allow limited access to your Steam account, but they do not allow access to changing your password, email address, or other sensitive information
You must get your cookies from [https://steamcommunity.com/](https://steamcommunity.com/) and not [https://store.steampowered.com/](https://store.steampowered.com/)
Manual Method [#manual-method]
Log In to the Steam Community Website [#log-in-to-the-steam-community-website]
Open your browser and log in to [https://steamcommunity.com/](https://steamcommunity.com/) with the account you use with SGI
Find Your Steam Cookies [#find-your-steam-cookies]
Press "**F12**" to open the Developer Tools
Navigate to the "**Application**" tab *(or "**Storage**" on Firefox)*
Under "**Cookies**", select `https://steamcommunity.com/`
Copy the "**value**" for both "**sessionid**" and "**steamLoginSecure**"
**OPTIONAL:** If you have either a "**steamParental**" or "**steamMachineAuth**" cookie, you will need to copy its "**value**" as well
Add Credentials to SGI [#add-credentials-to-sgi]
Open SGI and go to [](/docs/steam-credentials)
Paste your credentials into the appropriate fields and click
Reauthentication [#reauthentication]
Steam credentials expire after a certain period of time. When this happens, repeat the steps above
Signing Out [#signing-out]
To clear your stored credentials, click the button
Automated Method [#automated-method]
This method will not work if you have [Family View](https://store.steampowered.com/parental/) enabled on your Steam account. You **must disable [Family View](https://store.steampowered.com/parental/)** to use this method.
Open SGI and Navigate to the Settings [#open-sgi-and-navigate-to-the-settings]
Open SGI and go to [](/docs/steam-credentials)
Sign In via Steam [#sign-in-via-steam]
Click and sign in to your Steam account in the new window via:
* Username and password
* Scanning the QR Code
Automatic Cookie Retrieval [#automatic-cookie-retrieval]
Once signed in, SGI will automatically retrieve your `sessionid` and `steamLoginSecure` cookies and close the window
Reauthentication [#reauthentication-1]
Steam credentials expire after a certain period of time. SGI will attempt to automatically refresh your credentials when this happens. If automatic validation does happen to fail, you can still manually click and your credentials will be refreshed automatically
Signing Out [#signing-out-1]
To clear your stored credentials, or to sign in to another account, click the button
import { Step, Steps } from 'fumadocs-ui/components/steps';
Troubleshooting [#troubleshooting]
This page covers common issues and their solutions when using Steam Game Idler.
Always check the [FAQ](/docs/faq) section first, as many common questions are answered there
Preliminary Checks [#preliminary-checks]
Check System Requirements [#check-system-requirements]
* Windows 10/11 (64-bit)
* Steam client installed
* Internet connection
Verify Steam Setup [#verify-steam-setup]
* Steam client is running
* You're signed in to at least one Steam account
* Your Steam profile is set to public (for some features)
Check SGI Installation [#check-sgi-installation]
* SGI is installed in the default location
* You're running the latest version
* Windows Defender/antivirus isn't blocking SGI
Common Issues [#common-issues]
Installation & Startup Problems [#installation--startup-problems]
SGI Won't Install [#sgi-wont-install]
**Symptoms:** Installation fails or shows errors
**Solutions:**
* Run the installer as administrator
* Temporarily disable antivirus during installation
* Make sure you have sufficient disk space
* Download the installer again (it might be corrupted)
SGI Won't Start [#sgi-wont-start]
**Symptoms:** Application doesn't open or shows blank screen
**Solutions:**
* Make sure Steam is running and you're signed in
* Run SGI as administrator
* Check if Windows Defender is blocking the application
* Restart your computer and try again
Card Farming Issues [#card-farming-issues]
No Cards Dropping [#no-cards-dropping]
**Symptoms:** Card farming runs but no cards are received
**Solutions:**
* Check if games actually have card drops remaining
* Make sure you own the games (not family-shared)
* Wait longer - new accounts may have a 3-hour+ delay
* Check if the games are marked as private in your library
"Incorrect card farming credentials" Error [#incorrect-card-farming-credentials-error]
**Symptoms:** Card farming can't authenticate
**Solutions:**
* Update your Steam cookies following the [Steam Credentials](/docs/steam-credentials) guide
* Make sure you copied cookies from `steamcommunity.com`, not `store.steampowered.com`
* Check if you need additional cookies (`steamParental`, `steamMachineAuth`)
* Clear browser cache and get fresh cookies
Achievement Issues [#achievement-issues]
Achievement Unlocker Fails to Unlock Achievements [#achievement-unlocker-fails-to-unlock-achievements]
**Symptoms:** Achievement unlocker fails or shows errors
**Solutions:**
* Check if achievements are marked as "Protected" in [Achievement Manager](/docs/features/achievement-manager#special-flags)
* Verify the game has achievements
* Try unlocking them manually in [Achievement Manager](/docs/features/achievement-manager) first
Achievement Manager Shows "No achievements/statistics found" [#achievement-manager-shows-no-achievementsstatistics-found]
**Symptoms:** Empty achievement list for a game
**Solutions:**
* Set your Steam profile's Game Details to public
* Make sure the game actually has achievements and statistics
* Delete the games's achievement cache file and try again:
1. Close SGI
2. Navigate to `%appdata%/roaming/com.zevnda.steam-game-idler/cache/{user_id}/achievement_data`
3. Delete the game's cache file (e.g., `12345.json`)
Performance Issues [#performance-issues]
Too Many SteamUtility Processes [#too-many-steamutility-processes]
**Symptoms:** Many `SteamUtility.exe` processes in Task Manager
**Solutions:**
* This is normal when idling multiple games
* Reduce the number of games being idled simultaneously
* Restart SGI (or system) if processes don't close after stopping idling
Advanced Troubleshooting [#advanced-troubleshooting]
Check Log Files [#check-log-files]
Locate Log Files [#locate-log-files]
1. Press `Win + R` to open Run dialog
2. Navigate to `%appdata%/roaming/com.zevnda.steam-game-idler`
3. Open the `log.txt` file to check for errors
Analyze Logs [#analyze-logs]
Look for error messages, warnings, or unusual patterns that might indicate the issue
Report Issues [#report-issues]
If you find persistent errors, include relevant log excerpts when [reporting issues on GitHub](https://github.com/zevnda/steam-game-idler/issues/new?template=issue_report.yml)
Reset SGI Settings [#reset-sgi-settings]
This will reset all your customized settings and lists
Close SGI Completely [#close-sgi-completely]
Make sure SGI is not running
Delete Settings [#delete-settings]
1. Press `Win + R` to open Run dialog
2. Navigate to `%appdata%/roaming/com.zevnda.steam-game-idler`
3. Delete all files and folders in this directory
Restart SGI [#restart-sgi]
Launch SGI and reconfigure your settings
Registry Issues [#registry-issues]
If SGI can't find Steam, you may need reinstall Steam, or fix registry entries:
Open Registry Editor [#open-registry-editor]
1. Press `Win + R`, type `regedit`, press Enter
2. Navigate to `HKEY_CURRENT_USER\Software\Valve\Steam`
Check Steam Path [#check-steam-path]
Verify the `SteamPath` value points to your Steam installation (e.g., `C:\Program Files (x86)\Steam`)
Fix if Incorrect [#fix-if-incorrect]
Right-click `SteamPath`, select "Modify", and enter the correct path
Getting Help [#getting-help]
If these troubleshooting steps don't solve your issue:
1. **Check the [FAQ](/docs/faq)** for additional solutions
2. **Search existing issues** on the [GitHub repository](https://github.com/zevnda/steam-game-idler/issues)
3. **Create a new issue** with:
* Detailed description of the problem
* Steps to reproduce
* Your system information (Windows version, Steam version)
* Relevant log file excerpts
* Screenshots if applicable
When reporting issues, never share your Steam credentials or personal information
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Manage Steam Achievements Manually [#how-to-manage-steam-achievements-manually]
The Steam Achievement Manager tool allows you to manually unlock and lock achievements for your Steam games, as well as modify achievement statistics.
Achievements [#achievements]
Click in the sidebar
Click beneath the game image to open the achievement manager
On the achievement manager screen you will see a list of achievements for that game, if any are available
Click or next to an achievement to unlock or lock that specific achievement
Click or in the page header to unlock or lock all achievements for that game
Statistics [#statistics]
Click in the sidebar
Click beneath the game image to open the achievement manager
On the achievement manager screen, click the tab. You will see a list of statistics for that game, if any are available
Change the `value` of any statistics you want to modify and click
Special Flags [#special-flags]
Some games have achievements and statistics with [special flags](https://partner.steamgames.com/doc/features/achievements#3) set by the develper:
* **Protected:** Only official game servers can change these. You won't be able to change these in SGI
* **IncrementOnly:** You can only increase this statistic's value, not decrease it (5 → 6 is allowed, but 5 → 4 is not)
* **Hidden:** The achievement description is hidden, so it’s harder to know how to unlock it
For statistics with any flags, the flags will be shown under the statistic in the statistics tab.
For achievements with the "Hidden" flag, the description will be blurred until you hover over it with your mouse.
For achievements with the "Protected" flag, the unlock/lock buttons will be disabled.
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Unlock Steam Achievements Automatically [#how-to-unlock-steam-achievements-automatically]
The Steam Achievement Unlocker feature allows you to automatically unlock achievements for your Steam games over time, with customizable delays and ordering to mimic natural gameplay.
Configure this feature's settings in [Settings → Achievement Unlocker](/docs/settings/achievement-unlocker) before using it
Default Mode [#default-mode]
In default mode, achievements are unlocked in the order of global achievement percentage, with the delay set in [Settings → General → Unlock Interval](/docs/settings/achievement-unlocker#unlock-interval).
Click in the sidebar
Click and click on individual games to add and remove them, and then click
Optionally, you can customize the unlock order and set delays for individual achievements by [following these steps](#custom-order--unlock-delay)
Click
Custom Order & Unlock Delay [#custom-order--unlock-delay]
The `custom order` feature lets you set the exact order in which achievements are unlocked, and allows you to skip any that you don’t want unlocked.
The `unlock delay` is how long SGI waits after unlocking one achievement before unlocking the next.
> If you set a delay of 10 minutes on achievement one, SGI will unlock achievement one, wait 10 minutes, and then unlock achievement two.
Unlock delays override the global value set in [Settings → General → Unlock Interval](/docs/settings/achievement-unlocker#unlock-interval). If no unlock delay is set, the global value is used.
You can customize the order, set delays, or both — each step is optional.
Follow steps 1 and 2 from the [Default Mode](#default-mode) section above
Click below the game you want to customize
Drag and drop achievements by grabbing the to set their unlock order
Click to uncheck achievements that you want to exclude from being unlocked
The first row in the list is **Initial Delay** — enter a value (in minutes) to set how long SGI waits before unlocking the very first achievement
Enter a delay (in minutes) in the input field of each achievement to set how long SGI waits after unlocking that achievement before moving to the next one
Click and then click
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
Auto-Idle Steam Games on Startup [#auto-idle-steam-games-on-startup]
The Steam Automatic Idler feature allows you to automatically idle your Steam games when SGI is launched. This is useful for users who want to consistently boost playtime on specific games without having to manually idle them each time.
This makes for a hassle-free playtime boosting experience when used with the [Run At Startup](/docs/settings/general#run-at-startup) setting.
You can idle a maximum of 32 games simultaneously. This limit is imposed by the Steam client
Click in the sidebar
Click and click on individual games to add and remove them
The next time you launch SGI, the games in this list will be automatically idled
Or click to start idling them immediately
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Farm Steam Trading Cards Automatically [#how-to-farm-steam-trading-cards-automatically]
The Card Farming feature allows you to automatically farm trading cards from your Steam games without needing to download or play them. This is ideal for users looking to collect cards for badge crafting or marketplace sales efficiently.
You must add your [Steam Credentials](/docs/steam-credentials) before you can use this feature
Farm Games In The Card Farming List Only [#farm-games-in-the-card-farming-list-only]
Enable [`Farm Games In List`](/docs/settings/card-farming#farm-games-in-list) in
Click in the sidebar
Click and click on individual games to add and remove them
Click and then
Farm All Games With Drops Remaining [#farm-all-games-with-drops-remaining]
Enable [`Farm All Games`](/docs/settings/card-farming#farm-games-in-list) in
Click in the sidebar
Optionally, click and click on individual games to blacklist them from being farmed
Click
Account Restriction [#account-restriction]
New Steam accounts and accounts that have recently refunded a game fall under the [Limited User Account](https://help.steampowered.com/en/faqs/view/71D3-35C2-AD96-AA3A) restrictions and may have to spend a minimum of **$5.00 USD**, and/or wait three hours before the first card will drop.
Card Drop Times [#card-drop-times]
The time it takes for cards to drop varies from game to game. This interval is set by the developer. Some games drop a card every 30 minutes, while others may take up to 2 hours.
Blacklisting Games [#blacklisting-games]
You can blacklist specific games from being farmed for cards by clicking the button and then clicking the button next to individual games.
Blacklisted games will not be farmed for cards in either mode, even if they have card drops remaining, and even if you have added them to your card farming list.
Card Farming Algorithm [#card-farming-algorithm]
While farming cards, you may see `SteamUtility.exe (idle)` processes start and stop. This is normal — SGI uses the following method to farm cards as quickly as possible:
```markdown
1. Idle each game for 5 minutes
2. Stop idling for 1 minute
3. Idle each game for 15 seconds (first card drop should happen here)
4. Stop idling for 1 minute
5. Idle each game for 30 minutes
6. Stop idling for 1 minute
7. Idle each game for 15 seconds (next card drop should happen here)
8. Stop idling for 1 minute
9. Repeat the process
```
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Claim Free Steam Games Automatically [#how-to-claim-free-steam-games-automatically]
The Free Games feature allows you to discover and claim free games on Steam, either manually or automatically. This is perfect for users who want to expand their game library without spending money.
DLC, free-to-play games, and games that you already own are not shown in the Free Games list
Manual Redemption [#manual-redemption]
Click in the sidebar
Click beneath the game image to open its Steam store page where you can add the game to your library
After claiming a free game, refresh your games list clicking in the page header of
Automated Redemption [#automated-redemption]
Click in and sign in to your Steam account in the new window via:
* Username and password
* Scanning the QR Code
As free games become available, SGI will automatically attempt to redeem them to your Steam account
Notifications [#notifications]
When new free games are detected, SGI will show a notification in the bottom-right corner of your screen. You can disable the [Free Game Notifications](/docs/settings/free-games#free-game-notifications) in the settings.
What Counts as a Free Game? [#what-counts-as-a-free-game]
SGI only considers a game to be free if it is temporarily available for `$0.00` as part of a promotion or sale on the Steam store.
This is different to free-to-play games, which have no price and are always available for free. Free-to-play games are not shown in the Free Games list.
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Manage and Sell Steam Inventory Items Automatically [#how-to-manage-and-sell-steam-inventory-items-automatically]
The Inventory Manager feature allows you to manage your Steam inventory directly within SGI, including the ability to view all your marketable items (trading cards, foil cards, emoticons, backgrounds, and more) and sell them on the Steam marketplace.
This feature uses an undocumented Steam API endpoint with strict rate limits to fetch card prices. If you encounter errors while selling card or fetching card prices, please try increasing the [Sell Delay](/docs/settings/inventory-manager#sell-delay), or wait a few minutes before trying to fetch card prices again
You must add your [Steam Credentials](/docs/steam-credentials) before you can use this feature
Configure this feature's settings in [Settings → Inventory Manager](/docs/settings/inventory-manager) before using it
Click in the sidebar
List individual items [#list-individual-items]
Find the item you want to sell and input a sale price
Click to list the item
List selected items [#list-selected-items]
Find the items you want to sell and input a sale price for each one
Click to list only the selected items
List all items [#list-all-items]
Click to list all items
List duplicate items [#list-duplicate-items]
Click to automatically list all duplicate items for sale, keeping one copy of each
Confirm each listing via the Steam mobile app or email depending on your [Steam Guard](https://help.steampowered.com/en/faqs/view/06B0-26E6-2CF8-254C) settings
Click in the page header to update your card list
Removing Listings [#removing-listings]
Click to remove all your active listings from the Steam marketplace.
Pricing Details [#pricing-details]
When you use , SGI will list each item at its `highest_buy_order`. If that price isn't available, it will use its `lowest_sell_order`. If neither price is available, the item won't be listed.
You can choose which option to use by default by changing the [Default Sell Option](/docs/settings/inventory-manager#default-sell-option) in the settings.
Marketplace Fees [#marketplace-fees]
Steam charges a [15% transaction fee](https://help.steampowered.com/en/faqs/view/61F0-72B7-9A18-C70B#steamfee) on each marketplace sale, which is made up of two parts:
* **Steam Transaction Fee (5%)**: This goes to Valve for facilitating the transaction.
* **Game Publisher Fee (10%)**: This goes to the publisher of the game the item is from (not just Valve games—all publishers receive this fee for their own items).
SGI automatically accounts for the 15% Steam transaction fee when you set a sale price. The price you enter is what the **buyer pays** — SGI works out the correct listing price so that the buyer pays exactly that amount.
> If you set a price of `$0.50`, the buyer pays `$0.50` and you receive `$0.44` after fees.
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Manually Add Steam Games [#how-to-manually-add-steam-games]
In some cases, SGI may not automatically detect all the games in your Steam library [for reasons explained here](/docs/faq#:~:text=Why%20are%20some%20games%20not%20showing%20up%20in%20my%20games%20list%20in%20SGI%3F).
When this happens, you can manually add games to SGI to ensure they are included in features like [Card Farming](/docs/features/card-farming), [Achievement Unlocker](/docs/features/achievement-unlocker), and [Automatic Idler](/docs/features/auto-idler).
Adding games manually does not always guarantee that all SGI features will work correctly with those games
Click either , , , or in the sidebar, depending on which list you want to add the game to
Click on the button in the page header
In the modal that opens, enter the `game name` and `game id` of the game you want to add
The `game id` is the number in the game's store page URL. For example, here it is `570`:
```
https://store.steampowered.com/app/570/Dota_2/
```
Click to add the game to the list
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Boost Steam Game Playtime [#how-to-boost-steam-game-playtime]
The Steam Playtime Booster feature allows you to idle one or more games manually to boost their total playtime.
You can idle a maximum of 32 games simultaneously. This limit is imposed by the Steam client
Click in the sidebar
Click below the game to begin idling it
Click in the sidebar to view the games you are currently idling
Additional Information [#additional-information]
When you idle games with Playtime Booster, SGI creates a `SteamUtility.exe (idle)` window for each game to make Steam think you are playing those games. This window will close automatically when you stop idling the game, or when you exit SGI.
import DocsCTA from '@docs/components/content/DocsCTA';
import MockButton from '@docs/components/content/MockButton';
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Schedule Automated Steam Game Tasks [#how-to-schedule-automated-steam-game-tasks]
The Task Scheduling feature allows you to automate the execution of various task such as [Card Farming](/docs/features/card-farming), [Achievement Unlocker](/docs/features/achievement-unlocker), and [Automatic Idler](/docs/features/auto-idler).
For example, when Card Farming is finished, you can automatically run the Achievement Unlocker. Or when the Achievement Unlocker is finished, you can automatically run the Automatic Idler.
You can chain tasks together to create a workflow that suits your needs.
Click in the sidebar
In both the [Card Farming](/docs/settings/card-farming) and [Achievement Unlocker](/docs/settings/achievement-unlocker) settings tabs, you can configure the next task to run automatically once the current task is finished by enabling the `Schedule Next Task` option and selecting the task that you want to run next
Achievement Unlocker Settings [#achievement-unlocker-settings]
Idle Game [#idle-game]
While Achievement Unlocker is running, SGI will idle the game that it is currently unlocking achievements for
This is useful for making sure the game's playtime is also increased, making it look more legitimate
Skip Hidden Achievements [#skip-hidden-achievements]
Achievements that are listed as `hidden` by the game developer will be skipped
Schedule Next Task [#schedule-next-task]
Automatically start the selected feature when Achievement Unlocker finishes
For example, if you select "Card Farming", it will automatically start the Card Farming feature after Achievement Unlocker finishes
Time Range [#time-range]
Choose a time range for when SGI should unlock achievements. When outside of your scheduled time range, Achievement Unlocker will continue to run, but it will not unlock achievements. It will begin unlocking achievements again when back inside the scheduled time range
Unlock Interval [#unlock-interval]
This will determine how often SGI will unlock a new achievement *(in minutes)*.
After unlocking an achievement, SGI starts a countdown using a random time within your specified range. For example, with a range of `60 to 180 minutes`, SGI selects a random waiting period between 1-3 hours before unlocking the next achievement and starting a new countdown.
Card Farming Settings [#card-farming-settings]
Farm Games In List [#farm-games-in-list]
SGI will only farm cards for games that you've manually added to your Card Farming list, ignoring all others
Farm All Games [#farm-all-games]
SGI will automatically farm cards for all games in your library that still have trading card drops available
You can see which games in your Steam library have card drops remaining on your [Badges Page](https://steamcommunity.com/my/badges/)
Skip Unplayed Games [#skip-unplayed-games]
When enabled, SGI will skip any games that have not been played yet *(0 playtime)* during the card farming process
Unplayed Games Only [#unplayed-games-only]
When enabled, SGI will only farm cards for games that have not been played yet *(0 playtime)*
Highest Drops First [#highest-drops-first]
When enabled, SGI will prioritize games with the most card drops remaining, farming them before games with fewer drops
Lowest Drops First [#lowest-drops-first]
When enabled, SGI will prioritize games with the fewest card drops remaining, farming them before games with more drops
Schedule Next Task [#schedule-next-task]
Automatically start the selected feature when Card Farming finishes
For example, if you select "Achievement Unlocker", it will automatically start the Achievement Unlocker feature after Card Farming finishes
Customization Settings [#customization-settings]
Disable Tooltips [#disable-tooltips]
Disable non-essential tooltips in the app
Tooltips are small pop-up messages that pop up when you hover over certain elements in the app. They provide additional information about the element, but can be distracting for some users
Show Recommended Games [#show-recommended-games]
Enable or disable the recommended games carousel on the "Your Games" page
Show Recently Played Games [#show-recently-played-games]
Enable or disable the recently played games carousel on the "Your Games" page
Show Games With Card Drops [#show-games-with-card-drops]
Enable or disable the games with card drops carousel on the "Card Farming" page
Background Image [#background-image]
Set a custom background image for the SGI main window. You can choose any image file from your computer to personalize the look of the app
Theme [#theme]
Change the appearance of SGI by selecting a theme. You can choose between Default, Blue, Red, Purple or Black themes to match your preference or system settings
Debugging and Logs [#debugging-and-logs]
A log file is stored in `%appdata%/roaming/com.zevnda.steam-game-idler`. These logs are useful for debugging issues and understanding what SGI is doing behind the scenes.
If you have any issues while using SGI, check these logs as they may display information regarding the issue.
import MockButton from '@docs/components/content/MockButton';
Free Games Settings [#free-games-settings]
Free Game Notifications [#free-game-notifications]
Get native Windows notifications when free Steam games are available to add to your account
SGI will exclude games that you already own, but you will need to make sure your games list data is up to date by clicking the button in
Auto Redeem Free Games [#auto-redeem-free-games]
Automatically redeem free Steam games to your account when they become available
This feature requires you to sign in to your Steam account with the button and remain signed in for this feature to work
It is recommended to turn off [Free Game Notifications](/docs/settings/free-games#free-game-notifications) if you enable this feature, as you will not need to manually claim free games anymore
Also check [What Counts as a Free Game?](/docs/features/free-games#what-counts-as-a-free-game)
Individual Game Settings [#individual-game-settings]
Global Max Idle Time [#global-max-idle-time]
Set the maximum amount of time (in minutes) all games should be idled for. This setting takes precedence over individual `Max Idle Time` settings for each game
This only affects games that are idled by [Playtime Booster](/docs/features/playtime-booster) and [Automatic Idler](/docs/features/auto-idler), and does not affect games idled by [Card Farming](/docs/features/card-farming) or [Achievement Unlocker](/docs/features/achievement-unlocker)
Max Idle Time [#max-idle-time]
Set the maximum amount of time (in minutes) this game should be idled for. SGI will stop idling this game when the time limit is reached
This only affects games that are idled by [Playtime Booster](/docs/features/playtime-booster) and [Automatic Idler](/docs/features/auto-idler), and does not affect games idled by [Card Farming](/docs/features/card-farming) or [Achievement Unlocker](/docs/features/achievement-unlocker)
Max Card Drops [#max-card-drops]
Set the maximum amount of card drops you want [Card Farming](/docs/features/card-farming) to farm for this game before it stops
There are no set times or guarantees on card drop intervals, so even though SGI will try to stay within this limit as best as it can, it may not always be perfect
Max Achievement Unlocks [#max-achievement-unlocks]
Set the maximum amount of achievements you want [Achievement Unlocker](/docs/features/achievement-unlocker) to unlock for you. SGI will stop unlocking achievements for this game and remove it from the `achievement unlocker list` when the limit is reached
import MockButton from '@docs/components/content/MockButton';
General Settings [#general-settings]
Always Online [#always-online]
Prevents Steam from setting your status as away while SGI is running
When enabled, SGI will automatically change your Steam status back to online if you manually set it to away, offline, invisible, or any other status while the application is running
Beta Features [#beta-features]
Enable beta features that are not yet available in the stable version of SGI
Beta features may be unstable, change unexpectedly, or be removed at any time. If you experience any issues when using a beta feature, please report it on GitHub
Run At Startup [#run-at-startup]
Automatically launch SGI when Windows starts by adding it to your startup programs
This allows you to have SGI running in the background without needing to manually start it each time you log in to Windows
Start Minimized [#start-minimized]
Start SGI minimized to the system tray instead of showing the main window on startup. The app will remain hidden until manually opened via the system tray icon
Close to Tray [#close-to-tray]
Clicking the X button will minimize SGI to the system tray instead of closing it
When enabled, to fully exit the app, right-click the system tray icon and select `Quit`
Automatically Update Games List [#automatically-update-games-list]
Automatically check for new games and update the games list periodically (every 15 minutes) while SGI is running. This ensures that any changes to your Steam library, such as new game purchases or removals, are reflected in SGI without needing to manually refresh the games list
Language [#language]
Choose the language you want SGI to be displayed in. The language should be set automatically based on your system language, but you can change it to any of the supported languages
Currency [#currency]
Choose the currency you want to use when displaying prices in SGI, such as for [Inventory Manager](/docs/features/inventory-manager)
This currency will also be used to determine the sell price for inventory items
Steam Web API Key [#steam-web-api-key]
Allows users to provide their own Steam Web API key to fetch profile and game data. API keys are free for all users with a Steam account, you can [get yours here](https://steamcommunity.com/dev/apikey)
* Useful if users want to keep their Steam profile and game details set to private
* The API key must belong to the same account you're logged into in SGI. If using multiple accounts, you must set the API key for each account separately
* Some features may still be limited with private profiles
Inventory Manager Settings [#inventory-manager-settings]
Default Sell Option [#default-sell-option]
Choose the default sell price for inventory items when using the `sell all` button
Prices are fetched from the item's histogram data. For example, [this item](https://steamcommunity.com/market/listings/753/774861-Traitor) has it's own [price histogram data](https://steamcommunity.com/market/itemordershistogram?country=AU\&language=english\¤cy=21\&item_nameid=176219335). The histogram data is the same data that populates the tables on the [item's listing page](https://steamcommunity.com/market/listings/753/774861-Traitor)
The histogram data contains a `highest_buy_order` and `lowest_sell_order` price, which are used to determine the default sell price
Price Adjustment [#price-adjustment]
Add or subtract a fixed amount from the sale price of all inventory items listed for sale. This can be useful to adjust prices based on market trends or personal preferences
For example, if you set a price adjustment of `-0.10`, and sell an item listed at `1.00`, it will be sold for `0.90`
Sell Limit [#sell-limit]
Set minimum and maximum price limits for selling inventory items
If the final sale price is below the minimum or above the maximum, the card will not be listed for sale. This helps avoid selling cards at unfavorable prices
For example, if you set a minimum price of `0.50` and a maximum price of `2.00`, cards priced below `0.50` or above `2.00` will not be sold
Sell Delay [#sell-delay]
Set a delay between listing each trading card for sale to avoid being rate-limited by Steam's API
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { File, Folder, Files } from 'fumadocs-ui/components/files';
Build It Yourself [#build-it-yourself]
Prerequisites [#prerequisites]
* [Node.js](https://nodejs.org/en/download/prebuilt-installer) >= 20.0
* [Rust](https://www.rust-lang.org/tools/install) = 1.77.2
* [.NET SDK](https://dotnet.microsoft.com/en-us/download) >= 8.0
* [.NET Framework Developer Pack](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48) = 4.8
* [VS Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) = latest
* [WebView2](https://developer.microsoft.com/en-us/Microsoft-edge/webview2/) = latest - *pre-installed on Windows 11 and the latest version of Windows 10*
Clone Repo And Submodules [#clone-repo-and-submodules]
```bash
git clone --recursive https://github.com/zevnda/steam-game-idler.git
cd ./steam-game-idler
```
Install Dependencies [#install-dependencies]
npm
pnpm
yarn
bun
```bash
npm run install
```
```bash
pnpm run install
```
```bash
yarn run install
```
```bash
bun run install
```
Build Libraries [#build-libraries]
```bash
dotnet build ./libs/SteamUtility.csproj # Outputs to `/src-tauri/libs/`
```
Create Environment Files [#create-environment-files]
Create a `.env.dev` and `.env.prod` file in the root of `./steam-game-idler`
Add a `KEY` variable containing your [Steam Web API Key](https://steamcommunity.com/dev/apikey) to both `.env.dev` and `.env.prod`
```ini title=".env.dev" copy
KEY="ABC123******789XYZ"
```
```ini title=".env.prod" copy
KEY="ABC123******789XYZ"
```
Development or Production Build [#development-or-production-build]
npm
pnpm
yarn
bun
```bash
# Development
npm run tauri dev
# Production
npm run tauri build # Outputs to `/src-tauri/target/release/bundle/`
```
```bash
# Development
pnpm run tauri dev
# Production
pnpm run tauri build # Outputs to `/src-tauri/target/release/bundle/`
```
```bash
# Development
yarn tauri dev
# Production
yarn tauri build # Outputs to `/src-tauri/target/release/bundle/`
```
```bash
# Development
bun run tauri dev
# Production
bun run tauri build # Outputs to `/src-tauri/target/release/bundle/`
```
import { Step, Steps } from 'fumadocs-ui/components/steps';
How to Sign In [#how-to-sign-in]
You must have the [Steam client](https://store.steampowered.com/about) installed, running, and signed in to at least one account
If you are signed in to more than one Steam account in the Steam client, SGI will list all available accounts for you to choose from on the account selection screen
Install Steam [#install-steam]
Download and install the [Steam client](https://store.steampowered.com/about)
Sign In [#sign-in]
Sign in to your Steam account via the Steam client
Select Your Account [#select-your-account]
Open SGI and choose your account from the account selection screen by clicking your avatar
Continue [#continue]
After selecting your account, click the **Continue** button to proceed to the dashboard
import DocsCTA from '@docs/components/content/DocsCTA';
import { FaCheckCircle } from 'react-icons/fa';
import { Step, Steps } from 'fumadocs-ui/components/steps';
Install [#install]
Steam Game Idler can be used via either the [installer](/docs/get-started/install#installer-version) or [portable](/docs/get-started/install#portable-version) version. You can use the portable version of Steam Game Idler from a USB drive or any folder.
Installer Version [#installer-version]
Download [#download]
Download `Steam.Game.Idler_X.X.X_x64-setup.exe` from the [latest release](https://github.com/zevnda/steam-game-idler/releases/latest/) page on GitHub
Install [#install-1]
Run the installer and follow the steps of the installation guide
Run [#run]
After installation, you can launch SGI in one of three ways:
* Select "Run Steam Game Idler" and click "Finish" when prompted
* Run `Steam Game Idler.exe` from the installation directory.
* Defaults to `C:/Program Files/Steam Game Idler`
* Use the desktop shortcut created by the installer
Portable Version [#portable-version]
Download [#download-1]
Download `Steam.Game.Idler_X.X.X_x64-portable.zip` from the [latest release](https://github.com/zevnda/steam-game-idler/releases/latest/) page on GitHub
Extract [#extract]
Extract the contents of the `portable.zip` file to any folder you want
Run [#run-1]
Open the folder and run `Steam Game Idler.exe`