Epic Switcher

• Epic Switcher is designed to facilitate switching between accounts in the Epic Games Launcher
• Currently only for Windows

📥 Downloads

• Grab the latest version from the Releases page
• No install required

Tip

GitHub 'Releases' is GitHub jargon for downloads.

⚠️ What's the "Windows protected your PC" message?

⚠️ Windows SmartScreen Warning

When you run the app for the first time on Windows, you might see a warning like this:

🧠 What's actually happening?

This warning appears because the app is new and hasn't yet built trust with Microsoft SmartScreen, not because the app is malicious.

According to Microsoft's official documentation, SmartScreen determines whether to show this warning based on:

• Whether the file matches a known list of malicious apps or is from a known malicious site
• Whether the file is well-known and frequently downloaded
• Whether the app is digitally signed with a costly trusted certificate

This is just a generic warning — many indie or open-source apps trigger it until they build trust or pay for expensive certificates.

✅ How to dismiss and run

1. Click "More info"
2. Click "Run anyway"

🤨 Why not prevent the warning

To fully avoid SmartScreen warnings on Windows, developers are expected to:

• Buy and use an EV (Extended Validation) Code Signing Certificate
• Have enough users download the app over time to build a strong reputation score

These certificates can cost hundreds of dollars per year, which isn't always feasible for solo developers or small open-source projects.
We're focused on keeping this tool free and accessible.

For full details on how SmartScreen works, check out Microsoft's official documentation

Thanks for supporting open-source software! 💙

💡 Motivation

Epic Switcher started the same way most of my projects do: I, or people around me needed it.

Not too long ago, my siblings and I used to play Fortnite together. At some point, I gave her my main Fortnite account since I wasn't playing much anymore, which meant I had to make a separate account to play with them.

Aside from Fortnite (which I don't really play anymore), I'm really into Rocket League, and that's on my main account — the one I gave her. So I was constantly switching between Epic Games accounts, and the official launcher makes that way slower and more annoying than it should be. Logging out, logging back in, re-entering credentials, and dealing with 2FA almost every time got frustrating fast.

Existing solutions were either over-engineered, had outdated UIs, or were bundled with features I didn't want. I just wanted something:

• Fast
• Minimal
• One-click

So I built Epic Switcher. Once it proved useful, I open-sourced it in case it helps others with the same problem.

🖼️ Screens

Accounts

Customize avatar

Manage

Add session

Edit nickname

Delete session

Trust & Transparency

Settings

Note

Developer section below: The following content is intended for developers interested in the inner workings of Epic Switcher.

🗂️ Project Layout

Here's a quick overview of the main files and folders:

epic-switcher/
├── .github/
│   └── workflows/
│       └── release.yml         # GitHub Actions workflow for cross-platform builds + releases
│
├── backend/                    # Go backend logic
│   ├── helper/                 # Cross-platform utilities and command wrappers
│   │   ├── command_default.go  # Default command runner (used on non-Windows)
│   │   └── command_windows.go  # Windows-specific command runner (hides terminal window)
│   ├── models/                 # Data structures (LoginSession)
│   └── app.go                  # Main backend bindings exposed to the frontend
│
├── build/                      # App icons, packaging resources, and Wails build outputs
│   └── appicon.png             # Icon used for the app window and release packages
│
├── frontend/                   # Vue 3 frontend (served with Vite)
│   ├── src/
│   │   ├── main.jsx            # React app entry point
│   │   └── App.jsx             # Root React component
│   └── index.html              # HTML entry point
│
├── go.mod                      # Go dependencies (the Go module manifest)
├── go.sum                      # Go dependency checksums
├── main.go                     # App entry point (launches Wails)
├── release.js                  # Script to automate version bumping and pushing a new release
├── wails.json                  # Wails project configuration
└── README.md                   # You're reading it ✨

Note

The two files at app/helper/command_*.go are OS-specific and use Go build tags to automatically select the correct one during build time. This ensures clean handling of platform quirks without any runtime checks.

🔧 Dev Prerequisites

• To build or run in dev mode, follow the official Wails installation guide.
• You'll need Go installed, along with Node and a package manager like npm, yarn, or pnpm.

⚙️ Live Development

To start the app in dev mode:

wails dev

📦 Release Build

To generate a production-ready, standalone binary:

wails build

This compiles the app and outputs a native executable, ready to distribute.

🚀 Release Workflow

Epic Switcher uses a fully automated release pipeline powered by GitHub Actions and a helper script.

To create a new release, I run the release script:

npm run release

This will:

1. Prompt to select the version type (Patch, Minor, or Major)
2. Bump the version in frontend/package.json
3. Commit the version bump and create a Git tag
4. Push the commit and tag to GitHub

Note

The version bump uses a clear commit message like: chore: bump version to v1.2.3

When a v* tag is pushed, the release.yml GitHub Actions workflow is triggered.

• 🔧 Builds a native binary for Windows (.exe).
• 🗃 Renames and organizes the build artifacts.
• 📝 Creates a new GitHub Release and uploads the binary with an OS-specific label.

💡 The release process can be viewed under the repo's Actions tab

Note

Thanks to my previous work on my other project (AVD Launcher), I already had a release pipeline ready. It only required minor adjustments to fit this project.

Built with ❤️

This project is built with:

• Wails
• Go
• React

Credits

• Logo symbol by Epicons from SVGRepo

_{Made with 💛 by Symon}

_{Powered by Wails}