Skip to content

siriz/SLauncher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

53 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SLauncher

SLauncher Logo

A modern, multi-language app launcher for Windows

License: MIT .NET WinUI 3

Languages: English โ€ข ํ•œ๊ตญ์–ด โ€ข ๆ—ฅๆœฌ่ชž

Features โ€ข Installation โ€ข Usage โ€ข Building


โญ If you find this project useful, please consider giving it a star on GitHub!


๐ŸŒŸ Features

Core Functionality

  • โšก Quick Launch - Access your favorite apps, folders, and websites instantly
  • ๐Ÿ”‘ Global Hotkey - Show/hide launcher from anywhere (default: Ctrl + Space)
  • ๐Ÿ“‘ Tab Organization - Organize items into multiple tabs with custom names and colors
  • ๐Ÿ–ฑ๏ธ Drag & Drop - Easy item management with intuitive drag-and-drop
  • ๐Ÿ” Smart Search - Find items or directly open files/folders/URLs from search
  • ๐Ÿ“ Icon Scaling - Adjust icon size with slider or Ctrl + Mouse Wheel (0.25x - 6.00x)

Multi-Language Support

  • ๐Ÿ‡บ๐Ÿ‡ธ English
  • ๐Ÿ‡ฐ๐Ÿ‡ท ํ•œ๊ตญ์–ด (Korean)
  • ๐Ÿ‡ฏ๐Ÿ‡ต ๆ—ฅๆœฌ่ชž (Japanese)
  • โšก Real-time language switching - No restart required!

Modern UI

  • ๐ŸŽจ Windows 11 Design - Native WinUI 3 with Mica/Acrylic effects
  • ๐ŸŒ“ Theme Support - Automatically follows system dark/light theme
  • ๐Ÿ“บ Fullscreen Mode - Immersive launcher experience
  • โš–๏ธ Grid Alignment - Choose between Left or Center alignment
  • ๐ŸŽจ Tab Colors - 8 preset colors for tab customization

Performance & Portability

  • ๐Ÿ“ฆ Portable - All data stored in executable folder (UserCache/)
  • ๐Ÿš€ Fast Startup - Cached data for instant loading
  • ๐Ÿ’พ Favicon Cache - Website icons cached locally
  • ๐Ÿชถ Lightweight - Minimal resource usage

๐Ÿ“ธ Screenshots

Main Window

Main Window

Clean and intuitive interface with tab organization

Settings Window

Settings Window

Comprehensive settings with multi-language support


๐Ÿ“ฆ Installation

Requirements

  • Windows 10 version 1809 (Build 17763) or later
  • Windows 11 (recommended for best experience)
  • .NET 8.0 Runtime (included in self-contained builds)

Quick Install

  1. Download the latest release from Releases
  2. Extract the ZIP file to any folder
  3. Run SLauncher.exe
  4. (Optional) Enable "Start with Windows" in Settings

Portable Mode

All settings and data are stored in the UserCache folder next to the executable:

SLauncher/
โ”œโ”€โ”€ SLauncher.exe
โ””โ”€โ”€ UserCache/
    โ”œโ”€โ”€ Settings/   # User preferences
    โ”œโ”€โ”€ Files/        # Item data
    โ””โ”€โ”€ FaviconCache/    # Website icons

๐ŸŽฎ Usage

Adding Items

Method 1: Buttons

  • Add File: Click button and select .exe, .lnk, or any file
  • Add Folder: Click button and select any folder
  • Add Website: Click button and enter URL (e.g., https://github.com)

Method 2: Drag & Drop

  • Drag files, folders, or shortcuts directly into the window
  • Drag between tabs to move items
  • Drag one item onto another to create a group

Managing Items

Action Method
Edit Right-click item โ†’ Edit
Delete Right-click item โ†’ Delete or press Delete key
Create Group Drag one item onto another
Reorder Drag items to new positions

Tab Management

Creating Tabs

  • Click + button next to tabs
  • Each tab can have different items and settings

Tab Options (Right-click tab)

  • Rename - Give tab a custom name
  • Change Color - Choose from 8 preset colors
  • Delete - Remove tab (requires confirmation if has items)

Search

The search box supports multiple input types:

Input Type Example Result
Item Name notepad Search through all items
File Path C:\Windows\notepad.exe Open file directly
Folder Path C:\Users\Documents Open folder in Explorer
Website URL https://google.com Open in default browser
Search Query search:keyword Search with default browser

Keyboard Shortcuts

Shortcut Action
Ctrl + Space Show/hide launcher (customizable in Settings)
Ctrl + Mouse Wheel Adjust icon size (works anywhere in window)
Delete Delete selected item
Esc Close launcher (in fullscreen mode)
Enter Open first search result

Icon Scaling

Adjust icon size using:

  • Slider in bottom-right corner
  • Ctrl + Mouse Wheel anywhere in the window
  • Range: 0.25x to 6.00x

โš™๏ธ Settings

General Settings

  • Enable Fullscreen - Use launcher in fullscreen mode
  • Grid Alignment - Left (fills width) or Center (fixed width)
  • Start with Windows - Launch automatically at startup
  • Global Hotkey - Customize show/hide hotkey
    • Modifiers: Ctrl, Alt, Shift, Ctrl+Shift, Ctrl+Alt
    • Keys: Space, Tab, Enter, Esc, F1-F4
  • Language - Select preferred language (English, Korean, Japanese)

Cache Management

  • View Cache Size - Monitor favicon cache usage
  • Clear Cache - Remove all cached website icons
  • Open Cache Folder - Access cache directory directly
  • Cache Location - Portable: UserCache\FaviconCache\

๐Ÿ› ๏ธ Building from Source

Prerequisites

  • Visual Studio 2022 (17.8 or later)
    • Workload: ".NET Desktop Development"
    • Component: "Windows App SDK C# Templates"
  • Windows App SDK 1.5 or later
  • .NET 8.0 SDK

Clone and Build

# Clone repository
git clone https://github.com/siriz/SLauncher.git
cd SLauncher

# Restore NuGet packages
dotnet restore

# Build solution
dotnet build -c Release

# Or open in Visual Studio
start SLauncher.sln

Project Structure

SLauncher/
โ”œโ”€โ”€ SLauncher/   # Main WinUI 3 project
โ”‚   โ”œโ”€โ”€ Classes/     # Core classes
โ”‚   โ”‚   โ”œโ”€โ”€ LocalizationManager.cs # Multi-language support
โ”‚   โ”‚   โ”œโ”€โ”€ UserSettingsClass.cs     # Settings management
โ”‚   โ”‚   โ”œโ”€โ”€ GlobalHotkeyManager.cs   # Hotkey registration
โ”‚   โ”‚   โ””โ”€โ”€ IconHelpers.cs   # Icon extraction & cache
โ”‚   โ”œโ”€โ”€ Controls/   # Custom controls
โ”‚   โ”‚   โ”œโ”€โ”€ GridViewTile.xaml  # App tile control
โ”‚   โ”‚   โ”œโ”€โ”€ GridViewTileGroup.xaml   # Group control
โ”‚   โ”‚   โ””โ”€โ”€ AboutSectionControl.xaml # About page
โ”‚   โ”œโ”€โ”€ Strings/  # Localization resources
โ”‚   โ”‚   โ”œโ”€โ”€ en-US/Resources.resw     # English
โ”‚   โ”‚   โ”œโ”€โ”€ ko-KR/Resources.resw   # Korean
โ”‚   โ”‚   โ””โ”€โ”€ ja-JP/Resources.resw# Japanese
โ”‚   โ”œโ”€โ”€ MainWindow*.cs  # Main window (partial classes)
โ”‚   โ”‚   โ”œโ”€โ”€ MainWindow.xaml.cs  # Main logic
โ”‚   โ”‚   โ”œโ”€โ”€ MainWindow.UI.cs   # UI management
โ”‚   โ”‚   โ”œโ”€โ”€ MainWindow.Tabs.cs       # Tab management
โ”‚   โ”‚   โ”œโ”€โ”€ MainWindow.Items.cs      # Item management
โ”‚   โ”‚   โ”œโ”€โ”€ MainWindow.DragDrop.cs# Drag & drop
โ”‚   โ”‚   โ”œโ”€โ”€ MainWindow.Search.cs     # Search logic
โ”‚   โ”‚   โ””โ”€โ”€ MainWindow.Hotkeys.cs# Hotkey & tray
โ”‚   โ””โ”€โ”€ SettingsWindow*.cs  # Settings window (partial classes)
โ”‚       โ”œโ”€โ”€ SettingsWindow.xaml.cs    # Main logic
โ”‚       โ”œโ”€โ”€ SettingsWindow.Localization.cs # Language UI
โ”‚       โ”œโ”€โ”€ SettingsWindow.Cache.cs     # Cache management
โ”‚       โ”œโ”€โ”€ SettingsWindow.Hotkey.cs    # Hotkey config
โ”‚       โ””โ”€โ”€ SettingsWindow.Settings.cs  # Settings toggles
โ””โ”€โ”€ WinFormsClassLibrary/   # Helper library (file dialogs)

Partial Classes Pattern

Both MainWindow and SettingsWindow use partial classes for better code organization:

  • Each partial class file handles a specific feature area
  • Makes code easier to navigate and maintain
  • Follows the same pattern as MainWindow for consistency

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

Third-Party Libraries

  • WinUI 3 - MIT License
  • CommunityToolkit.WinUI - MIT License
  • WinUIEx - MIT License
  • System.Drawing.Common - MIT License

๐Ÿ™ Acknowledgments


๐Ÿ“Š Changelog

SLauncher v1.0.0 (Latest)

  • โœจ Multi-language support (English, Korean, Japanese)
  • โœจ Real-time language switching
  • โœจ Partial class refactoring for better code organization
  • โœจ Window-wide Ctrl+MouseWheel icon scaling
  • ๐Ÿ› Fixed Grid Alignment localization
  • ๐Ÿ› Fixed Cache Management subtitle localization
  • ๐Ÿ“ Comprehensive localization (90+ strings per language)

Made with โค๏ธ for Windows power users

โฌ† Back to Top

About

A modern, multi-language app launcher for Windows

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages