osu!Launcher is a lightweight PowerShell script designed for osu! players who want a clean, performance-focused setup before every session.

It automatically handles StreamCompanion, Wallpaper Engine (Steam), and osu!, so you can focus on farming pp — not managing background applications.

---

✨ Features

• 🚀 Launches StreamCompanion (only if it’s not already running)
• 🖼️ Stops Wallpaper Engine (Steam) to reduce GPU/CPU usage
• 🎯 Launches osu! with High process priority
• ⏳ Waits until osu! is closed
• 🔁 Restarts Wallpaper Engine automatically
• 🌐 Opens your osu! profile at the end of the session
• 🔔 Displays a small end-of-session notification

---

📋 Requirements

• Windows
• osu!
• StreamCompanion
• Wallpaper Engine (Steam version)
• PowerShell (included by default on Windows)

---

📌 StreamCompanion setup (important)

Before using this script, you must install and configure StreamCompanion.

1️⃣ Install StreamCompanion

Download it from the official repository:
👉 https://github.com/Piotrekol/StreamCompanion/releases

2️⃣ Configure the in-game overlay

To correctly set up the in-game overlay, follow this tutorial:
👉 https://www.youtube.com/watch?v=uTDFBh2MwIE

This step is required for the PP counter and overlay to work properly in osu!.

---

⚙️ Configuration

All user-specific values are stored in config.txt.
You do not need to edit the PowerShell script.

Config :

OSU_PATH=C:\Path\To\osu!.exe

STREAMCOMPANION_PATH=C:\Path\To\osu!StreamCompanion.exe

OSU_PROFILE_ID=12345678

🧭 How to fill the variables

🎯 OSU_PATH (osu!.exe location)

Open osu!

Press Ctrl + Shift + Esc to open Task Manager

Find osu!

Right-click → Open file location

Copy the full path to osu!.exe (for exemple "C:\Users\YourName\AppData\Local\osu!\osu!.exe")

🚀 STREAMCOMPANION_PATH

If StreamCompanion was installed in the default location, you usually don’t need to change this value.

Default path:

C:\Program Files (x86)\StreamCompanion\osu!StreamCompanion.exe

If not:

Locate where StreamCompanion is installed

Find osu!StreamCompanion.exe

Copy the full path

🌐 OSU_PROFILE_ID

Open your osu! profile in a browser

Look at the URL:

https://osu.ppy.sh/users/30540445

The number at the end is your profile ID

Example:

OSU_PROFILE_ID=30540445

▶️ Usage

Simple method

Right-click osu_mode.ps1

Select Run with PowerShell

Recommended method (desktop launcher)

Create a shortcut with this target: powershell.exe -ExecutionPolicy Bypass -File "C:\path\to\osu_mode.ps1"

You can also change the shortcut icon to the osu! icon for a cleaner setup.

🧠 Why use this?

Lower background resource usage = smoother gameplay

No need to manually stop / restart Wallpaper Engine

Automatic setup before every osu! session

Quick access to your profile and progression after playing

Perfect for long grind sessions or streaming setups.

🚧 Possible future improvements

Stream mode (OBS auto-launch)

Session logs

pp tracking (before / after)

Compiled .exe version

Multi-profile support

Pull requests and suggestions are welcome 👀

📜 License MIT License Use it, modify it, break it, improve it — just enjoy osu!.

💬 Credits

Made by an osu! player, for osu! players.