{"id":44683890,"url":"https://github.com/devnullvoid/dms-command-runner","last_synced_at":"2026-02-15T05:09:56.435Z","repository":{"id":319745496,"uuid":"1079432814","full_name":"devnullvoid/dms-command-runner","owner":"devnullvoid","description":"Command Runner plugin for DankMaterialShell - Execute shell commands from the launcher","archived":false,"fork":false,"pushed_at":"2026-01-30T08:15:42.000Z","size":146,"stargazers_count":5,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-31T00:14:31.842Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"QML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devnullvoid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-19T19:46:13.000Z","updated_at":"2026-01-30T08:15:46.000Z","dependencies_parsed_at":"2025-10-20T04:34:07.252Z","dependency_job_id":null,"html_url":"https://github.com/devnullvoid/dms-command-runner","commit_stats":null,"previous_names":["devnullvoid/dms-command-runner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devnullvoid/dms-command-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devnullvoid%2Fdms-command-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devnullvoid%2Fdms-command-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devnullvoid%2Fdms-command-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devnullvoid%2Fdms-command-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devnullvoid","download_url":"https://codeload.github.com/devnullvoid/dms-command-runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devnullvoid%2Fdms-command-runner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29469997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T04:35:06.950Z","status":"ssl_error","status_checked_at":"2026-02-15T04:33:41.357Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-15T05:09:56.322Z","updated_at":"2026-02-15T05:09:56.417Z","avatar_url":"https://github.com/devnullvoid.png","language":"QML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Command Runner\n\nA DankMaterialShell launcher plugin for executing shell commands directly from the launcher with history tracking and preset shortcuts.\n\n![Command Runner Screenshot](screenshot.png)\n\n## Features\n\n- **Execute Commands** - Run any shell command in terminal or background\n- **Command History** - Track and reuse recently executed commands\n- **Common Shortcuts** - Quick access to frequently used commands (htop, btop, ncdu, etc.)\n- **Terminal Support** - Auto-detect or configure your preferred terminal emulator\n- **Background Execution** - Run commands silently without opening a terminal\n- **Clipboard Copy** - Copy commands to clipboard before executing\n- **Configurable Trigger** - Default `\u003e` or set your own trigger\n\n## Installation\n\n### From Plugin Registry (Recommended)\n```bash\n# Coming soon - will be available via DMS plugin manager\n```\n\n### Manual Installation\n```bash\n# Copy plugin to DMS plugins directory\ncp -r CommandRunner ~/.config/DankMaterialShell/plugins/\n\n# Enable in DMS\n# 1. Open Settings (Ctrl+,)\n# 2. Go to Plugins tab\n# 3. Click \"Scan for Plugins\"\n# 4. Toggle \"Command Runner\" to enable\n# 5. Configure your terminal emulator in plugin settings\n```\n\n## Configuration\n\n**Important**: Configure your terminal before first use!\n\n1. Open Settings → Plugins → Command Runner\n2. Set **Terminal**: Your terminal emulator (e.g., `kitty`, `alacritty`, `foot`)\n3. Set **Exec flag**: The flag for executing commands (e.g., `-e` for most terminals)\n\n### Common Terminal Configurations\n\n| Terminal | Command | Exec Flag |\n|----------|---------|-----------|\n| kitty | `kitty` | `-e` |\n| alacritty | `alacritty` | `-e` |\n| foot | `foot` | `-e` |\n| wezterm | `wezterm` | `start` |\n| gnome-terminal | `gnome-terminal` | `--` |\n| konsole | `konsole` | `-e` |\n| xterm | `xterm` | `-e` |\n\n## Usage\n\n### Execute Commands in Terminal\nNote: Avoid triggers reserved by DMS or other plugins (e.g., `/` is used for file search).\n\n1. Open launcher (Ctrl+Space)\n2. Type `\u003e` followed by command\n3. Examples:\n   - `\u003e htop` - System monitor\n   - `\u003e btop` - Modern resource monitor\n   - `\u003e ls -la` - List files with details\n   - `\u003e journalctl -f` - View live system logs\n4. Select \"Run: command\" and press Enter\n\n### Execute Commands in Background\n1. Type command as above\n2. Select \"Run in background: command\"\n3. Command executes silently without terminal window\n\n### Copy Command to Clipboard\n1. Type command\n2. Select \"Copy: command\"\n3. Command copied to clipboard for use elsewhere\n\n### Use Command History\n- Recent commands appear automatically in the list\n- Click any historical command to re-execute\n- History persists across sessions\n\n### Common Command Shortcuts\nAccess pre-configured shortcuts without typing:\n- `htop` - Interactive process viewer\n- `btop` - Resource monitor\n- `ncdu` - Disk usage analyzer\n- `nmtui` - Network manager TUI\n- `ranger` - File manager\n- `neofetch` / `fastfetch` - System info\n- And more!\n\n## Settings\n\n- **Trigger**: Set custom trigger (`\u003e`, `$`, `!`, `run`, etc.) or disable for always-on\n  - Avoid triggers reserved by DMS or other plugins (e.g., `/` is used for file search).\n- **Terminal Emulator**: Configure which terminal to use\n- **Exec Flag**: Set the command execution flag for your terminal\n- **Max History Items**: Configure history size (1-100 items)\n- **Clear History**: Remove all stored commands\n\n## Examples\n\n### System Monitoring\n```\n\u003e htop              # Interactive process viewer\n\u003e btop              # Modern resource monitor\n\u003e journalctl -f     # Live system logs\n\u003e df -h             # Disk usage\n\u003e free -h           # Memory usage\n```\n\n### File Operations\n```\n\u003e ls -la            # List all files\n\u003e ncdu ~            # Analyze disk usage\n\u003e ranger            # File manager\n```\n\n### Network\n```\n\u003e nmtui             # Network manager\n\u003e ip addr           # Network interfaces\n\u003e ping 8.8.8.8      # Test connectivity\n```\n\n### Development\n```\n\u003e vim config.txt    # Edit file in vim\n\u003e git status        # Check git status\n\u003e npm install       # Install packages\n```\n\n## Requirements\n\n- DankMaterialShell \u003e= 0.1.0\n- Terminal emulator (kitty, alacritty, foot, etc.)\n- `wl-copy` (for clipboard support)\n- Wayland compositor\n\n## Compatibility\n\n- **Compositors**: Niri and Hyprland\n- **Distros**: Universal - works on any Linux distribution\n- **Terminals**: Supports all major terminal emulators\n\n## Technical Details\n\n- **Type**: Launcher plugin\n- **Trigger**: `\u003e` (configurable)\n- **Language**: QML (Qt Modeling Language)\n- **Storage**: Command history stored in DMS settings\n\n## Troubleshooting\n\n### Commands not launching?\n1. Verify terminal is configured in plugin settings\n2. Check terminal is installed: `which kitty` (or your terminal)\n3. Verify exec flag matches your terminal\n\n### Terminal opens but command doesn't run?\n- Ensure exec flag is correct for your terminal\n- Most terminals use `-e`, but some (wezterm) use `start`\n\n## Contributing\n\nFound a bug or want to add features? Open an issue or submit a pull request!\n\n## License\n\nMIT License - See LICENSE file for details\n\n## Author\n\nCreated for the DankMaterialShell community\n\n## Links\n\n- [DankMaterialShell](https://github.com/AvengeMedia/DankMaterialShell)\n- [Plugin Registry](https://github.com/AvengeMedia/dms-plugin-registry)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevnullvoid%2Fdms-command-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevnullvoid%2Fdms-command-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevnullvoid%2Fdms-command-runner/lists"}