<p align="center"> <img src="assets/logo.png" width="512" alt="SceneShift Logo"> </p> <h1 align="center">SceneShift</h1>

Overview

SceneShift is a terminal-based process optimizer for Windows that helps you quickly free system resources by managing background applications. Designed for gamers, developers, and content creators who need maximum performance on demand.

If you regularly close dozens of apps before gaming, rendering, or streaming, SceneShift turns that ritual into a single keyboard command.

What SceneShift Does

SceneShift allows you to:

Kill or suspend background applications to free RAM and CPU
Create presets for different performance scenarios
Restore applications after your session
Track session history and undo operations
Share configurations across machines

Built for users who want a lightweight, keyboard-driven alternative to Task Manager.

Key Features

Process Management

Kill Mode: Permanently terminate processes for maximum resource reclamation
Suspend Mode: Freeze processes without closing them (preserves state)
Resume Mode: Unfreeze suspended processes
Restore Mode: Relaunch terminated applications

Safety System

Protected Processes: Critical Windows processes cannot be modified
Safe to Kill Lists: Community-curated lists of safe-to-terminate applications
Safety Indicators: Visual markers showing process risk levels

Productivity Tools

Presets: Define performance scenes with single-key triggers
Session History: Review all operations performed
Undo Functionality: Reverse the last operation
Configuration Profiles: Export and import your entire setup

Resource Monitoring

Real-time Stats: View CPU and RAM usage per process
Status Indicators: See which processes are running, suspended, or terminated
RAM Tracking: Monitor memory reclaimed after optimization

Installation

Option 1: Scoop (Recommended)

scoop bucket add tandukuda https://github.com/tandukuda/scoop-bucket
scoop install sceneshift

Option 2: Manual Download

Download the latest release from the Releases page
Extract the archive to your preferred location
Run SceneShift.exe as Administrator

Option 3: Build from Source

# Prerequisites: Go 1.21+, rsrc
go install github.com/akavel/rsrc@latest

# Clone and build
git clone https://github.com/tandukuda/sceneshift.git
cd sceneshift
build-release.bat

Quick Start

First Launch

On first launch, SceneShift will:

Create a default configuration file
Ask you to choose a color theme
Present the main menu

Administrator privileges are required for process management.

Basic Workflow

Add Applications: Press n to add apps you want to manage
Select Apps: Use arrow keys and Space to select processes
Choose Action:
- Press K to kill selected processes
- Press S to suspend them
- Press U to resume suspended processes
- Press R to restore terminated processes
Confirm: Wait through the 5-second countdown or press q to cancel

Creating Presets

Presets allow you to switch your system into predefined performance states with a single keypress.

Press p to open preset manager
Press n to create a new preset
Enter a name (e.g., "Gaming Mode")
Assign a hotkey (e.g., "1")
Select which apps to target
Press Enter to save

Now press 1 in the main menu to activate Gaming Mode.

Importing and Exporting Configurations

Share your optimized setup across machines or with the community.

Export:

Press Ctrl+E in the main menu
Enter a description and optional author name
Press Enter
Profile saved as sceneshift-profile-YYYY-MM-DD.json

Import:

Press i in the main menu
Select a profile from the list
Press Enter to merge with current configuration

Keybindings

Navigation

↑/k: Move up
↓/j: Move down
Space: Toggle selection
a: Select all
x: Deselect all

Actions

K: Kill selected processes
S: Suspend selected processes
U: Resume suspended processes
R: Launch/restore processes

Management

n: New app entry
e: Edit selected app
d: Delete selected app
p: Manage presets
t: Change theme
w: Manage exclusion list

Advanced

h: View session history
u or Ctrl+Z: Undo last operation
Ctrl+E: Export configuration
i: Import configuration
?: Toggle help
q: Quit

Configuration

Configuration files are stored in the executable directory:

SceneShift/
├── SceneShift.exe
├── config.yaml          # Apps, presets, exclusion list, keybindings
└── theme.yaml           # Active theme colors

Example config.yaml

apps:
  - name: Discord
    process_name: Discord.exe
    exec_path: C:\Users\...\Discord.exe
    selected: false
    safety_level: safe

presets:
  - name: Gaming Mode
    key: "1"
    apps: [Discord, Chrome, Spotify]

protection:
  exclusion_list:
    - explorer.exe
    - dwm.exe
    - csrss.exe

safe_to_kill:
  bloatware:
    - OneDrive.exe
    - msedge.exe
  chat_apps:
    - Discord.exe
    - Slack.exe
  game_launchers:
    - Steam.exe
    - EpicGamesLauncher.exe

Themes

Built-in themes:

Rose Pine Moon (default)
Dracula
Nord
Gruvbox Dark
Cyberpunk

Press t to switch themes. Press e in the theme menu to create custom colors.

Safety and Responsibility

SceneShift is a power tool. Best practices:

Save your work before switching scenes
Test new presets carefully
Review the exclusion list before modifying it
Back up your configuration before major changes

SceneShift includes safeguards for critical Windows processes, but users are responsible for their actions.

Use Cases

Gaming

Suspend Discord, Chrome, and game launchers to reclaim RAM before launching AAA titles. Resume everything afterward with one command.

Development

Kill notification daemons, chat apps, and update services before compiling large projects or running resource-intensive builds.

Content Creation

Terminate background processes before recording or streaming to prevent frame drops and ensure consistent performance.

3D Rendering

Free maximum RAM by suspending all non-essential applications before starting long render jobs in Blender or Maya.

Troubleshooting

SceneShift won't start

Ensure you are running as Administrator
Check that all DLL dependencies are present
Verify Windows version is 10 or newer

Process won't terminate

Process may be protected (check for shield icon)
Try suspend mode instead of kill mode
Verify process name matches exactly

Apps don't restore

Check that executable paths are correct
Ensure files haven't been moved or deleted
Verify you have permission to launch the application

For more help, see the Documentation or open an issue on GitHub.

Community and Contributions

SceneShift is shaped by real-world usage and feedback. Contributions welcome:

Share your presets and configurations
Report bugs and edge cases
Improve documentation
Suggest new features

Special thanks to contributors and users who helped shape v2.2.0:

@vasudev-gm for safe-to-kill process lists and naming improvements

Support the Project

If SceneShift is part of your workflow, consider supporting development:

Ko-fi: https://ko-fi.com/tandukuda
PayPal: https://paypal.me/justbams

Changelog

See CHANGELOG.md for version history and release notes.

License

This project is licensed under the MIT License. See LICENSE for details.

Links

Built with Bubble Tea by Charm

Process lists curated by the community

Built with ❤️ by tandukuda

⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature • ☕ Ko-Fi

</div>

SceneShift

Install / Use

README