Skip to main content

Tool to automatically add games from the Epic Games Launcher to Steam

Project description

steamsync cli

PyPI version

Simple command line tool (and poorly documented library!) to automatically add games from the Epic Games Launcher to Steam.

Makes playing all of those free EGS games in Big Picture Mode a lot easier. In my experience, when launching from Big Picture Mode, Steam Input works as expected (even in Fortnite!).

steamsync will scan all of the Epic Games Store games installed on your computer and add them to your Steam Library. If a shortcut with the same path already exists, it will skip it, so it's safe to import all of your games over and over.

steamsync attempts to be simple. It does not attempt to fetch any banner art, it simply uses the executable's icon as the icon in steam.

Installation (brief)

Requires > Python 3.8

$ pip install steamsync
$ steamsync

Installation and Usage (for beginners)

  1. Download Python 3.8
  2. Choose the latest version of Python 3.8, and get the "Windows x86-64 executable installer" option
  3. When installing Python, make sure to install pip and to add Python to your PATH
  4. Open Commmand Prompt (search Start Menu for cmd.exe)
  5. Type pip install steamsync, press enter.
  6. Make sure Steam is not running!
  7. Type, press enter. The tool will walk you through everything else. Press ctrl+c if you get scared and want to abort.


(steamsync-py3.10) PS C:\Users\jayde\Documents\GitHub\steamsync> steamsync -h  
usage: steamsync [-h] [--source {legendary,epicstore,itchio,xbox}] 
                      [--egs-manifests EGS_MANIFESTS] 
                      [--legendary-command LEGENDARY_COMMAND] 
                      [--itch-library ITCH_LIBRARY] 
                      [--steam-path STEAM_PATH] 
                      [--steamid STEAMID] 

Utility to import games from the Epic Games Store, Microsoft Store (Xbox for 
Windows), and to your Steam library

  -h, --help            show this help message and exit
  --source {legendary,epicstore,itchio,xbox}
                        Storefronts with games to add to Steam. If unspecified, 
                        uses all sources. Use argument multiple times to select 
                        multiple sources (--source itchio --source xbox). 
                        (default: None)
  --egs-manifests EGS_MANIFESTS
                        Path to search for Epic Games Store manifest files 
                        (default: C:\ProgramData\Epic\EpicGamesLauncher\Data\Manifests)
  --legendary-command LEGENDARY_COMMAND
                        Command/Path to run 'legendary' executable 
                        (default: legendary)
  --itch-library ITCH_LIBRARY
                        Path where the app installs games 
                        (default: C:\Users\jayde\AppData\Roaming\itch\itch\apps)
  --steam-path STEAM_PATH
                        Path to Steam installation (default: C:\Program Files (x86)\Steam)
                        Install all games found, do not prompt user to select which 
                        (default: False)
                        Instead of skipping existing shortcuts (ones with the 
                        same path), overwrite them with new data. Useful to 
                        repair broken shortcuts. 
                        (default: False)
                        Remove shortcuts to games that no longer exist. Uses 
                        selected sources to determine if games without executables 
                        (uri or Xbox) still exist. i.e., if you don't include 
                        xbox source all xbox games will appear to be missing. 
                        (default: False)
                        Don't backup Steam's shortcuts.vdf file to shortcuts.vdf-{time}.bak 
                        (default: False)
  --steamid STEAMID     SteamID or username to install the shortcuts to, only 
                        needed if >1 accounts on this machine 
                        (default: )
                        Use a launcher URI (`com.epicgames.launcher://apps/fortnite?action=launch&silent=true`) 
                        instead of the path to the executable (eg `C:\Fortnite\Fortnite.exe`). 
                        Some games with online functionality (eg GTAV) require 
                        being launched through the EGS. Other games work better with Steam      
                        game streaming (eg Steam Link or Big Picture) using the path to the executable. 
                        (default: False)
                        Download Steam grid and Big Picture art from steam's 
                        servers for games we're adding. Only downloads art that 
                        we haven't already downloaded. 
                        (default: False)
                        Download Steam grid and Big Picture art for all non-steam 
                        game shortcuts. Only downloads art that we haven't already 
                        downloaded. Implies --download-art 
                        (default: False)
                        Initialize Steam shortcuts.vdf file if it doesn't exist.
                        (default: False)


Does this work on OSX?

Probably not. You may have luck with --egs-manifests and --steam-path, maybe MRs are welcome

What about Linux?

When using Legendary or Heroic steamsync should work. Use --legendary-command option to path to correct binary if not already in PATH. Not tested with Rare Not tested with EGS running through Wine.

It doesn't work!

Open an issue on GitHub.

Steam crashed after opening my library the first time, but worked after that

Weird, right? Mine did that too ¯\(ツ)/¯. Maybe loading 52 shortcuts at once was too much for it.

I want to go back to the way it was

steamsync will backup your shortcuts.vdf file by default every time you run it.

Go to C:\Program Files (x86)\Steam\userdata\{your steam userid}\config. You will see some shortcuts.vdf-DATE.bak files. Delete shortcuts.vdf (this is the one steamsync modified), and rename the .bak file you want to use to shortcuts.vdf, restart steam.

I got a could not find shortcuts file at ... error

Try making a shortcut in Steam (Library ➡ ➕ Add Game ➡ Add a Non-Steam Game...) first. By default steamsync will not make a shortcuts.vdf file for you if it isn't already there. You can enable the experimental functionality for automatically initializing the shortcuts.vdf file with the --init-shortcuts-file option.

Can this run automagically?

Yes, yes it can! (you may need to adjust paths below)

  1. Open Task Scheduler (start + type "task...")
  2. Action Menu ➡ Create Basic Task
  3. Fill in a name and description
  4. Set the trigger you want to use (daily, log in, etc), Next
  5. Action = Start a Program
  6. Program/Script is pythonw
  7. Add arguments C:\Users\{username}\AppData\Local\Programs\Python\Python38\Scripts\ --all --steamid={steam id}, Next
  8. Make sure to restart Steam once in a while


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

steamsync-0.4.1.tar.gz (24.1 kB view hashes)

Uploaded source

Built Distribution

steamsync-0.4.1-py3-none-any.whl (25.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page