Files
Taskbar-Launcher/README.md
2026-08-26 22:43:58 -04:00

93 lines
2.8 KiB
Markdown

# Taskbar Launcher
Taskbar Launcher is a small Windows tray launcher for folders, applications, scripts, files, and nested menus.
## Download
Download the compiled Windows release from:
[Taskbar Launcher Releases](https://git.mget.ca/MGET/Taskbar-Launcher/releases)
## Features
- System tray launcher
- Global hotkey, default `Ctrl+Alt+Space`
- Search/filter in the launcher popup with parent menu context
- Keyboard navigation in the launcher popup
- Tooltips for launcher items, menu paths, targets, and arguments
- Recent items section for quickly relaunching entries
- Nested menus, drag/drop ordering, and drag/drop item creation in Settings
- Right-click launcher entries to edit them in Settings
- Right-click launcher entries to pin or unpin them from the top
- Right-click launcher entries or Settings items to temporarily disable them
- Right-click app/file entries to open their containing folder
- Optional run-as-administrator mode for app and file entries
- Optional working folder and start-minimized launch options for app and file entries
- Per-item notes, visible in launcher tooltips and searchable from the popup
- Validate missing app, file, and folder targets from Settings
- Export and import selected items or menu sections
- Sort a selected menu or item level alphabetically
- Right-click item duplication in Settings
- Right-click items in Settings to pin them to the top of their menu
- Per-item icon and display mode
- Automatic icon selection from app/folder targets
- Portable `config.json`
- Backup/restore config
- Optional Start with Windows shortcut
- Windows light/dark theme support
## Screenshots
### Launcher Popup
![Taskbar Launcher popup](docs/screenshots/launcher-popup-exact.png)
### Settings
![Taskbar Launcher settings](docs/screenshots/settings-window-exact.png)
### About
![Taskbar Launcher about window](docs/screenshots/about-window-exact.png)
## Project Layout
```text
TaskbarLauncher/
App.xaml
MainWindow.xaml
Assets/
Models/
Services/
Views/
docs/
```
## Build
Requires the .NET 10 SDK on the developer machine.
```powershell
dotnet build
```
## Config Files
`config.json` is local runtime data and is ignored by Git. Keep your personal launcher menu there for testing.
`config.example.json` is a public-safe sample config for documentation and reference. New users do not need to copy it; if `config.json` is missing, the app creates a clean starter config on first run.
Personal test configs should stay in `config.json`; public release packages do not include private configs.
## Versioning
The app version is controlled in `TaskbarLauncher.csproj`.
Recommended release flow for maintainers:
1. Update `<Version>` in `TaskbarLauncher.csproj`.
2. Commit the change.
3. Build a release package locally.
4. Tag the release, for example `v1.0.1`.
5. Upload the release zip to Gitea Releases.