swiftbar/SwiftBar
SwiftBar
SwiftBar ist ein macOS-Menüleisten-Anpassungstool und ein Plugin-basierter Statusmonitor, der die Ausgabe ausführbarer Skripte und Shell-Befehle direkt in der System-Menüleiste anzeigt. Es fungiert als Shell-Skript-Dashboard, das Echtzeitdaten und Skriptergebnisse als interaktive Menüpunkte und Dropdowns rendert.
Das Projekt zeichnet sich dadurch aus, dass es als Automatisierungsschnittstelle fungiert, die sich in System-Shortcuts und externe URL-Schemata integriert, um Aktionen auszulösen und Statusanzeigen zu aktualisieren. Es unterstützt die Installation von Community-Skripten und das Paketieren komplexer Plugin-Assets in lokale Verzeichnisse.
Das System deckt ein breites Spektrum an Funktionen ab, einschließlich metadatengesteuertem Rendering für Schriftarten und Farben, intervallbasiertem Polling und Echtzeit-Datenstreaming sowie die Integration eingebetteter Web-Views innerhalb der Menüoberfläche. Es bietet zudem Zugriff auf Umgebungsvariablen für dynamische Logik und ermöglicht es, Skriptausführungsergebnisse in einem Terminal-Emulator für Debugging-Zwecke zu starten.
Features
- Shell Script Execution Engines - Runs executable shell scripts as plugins and renders their standard output in the macOS menu bar.
- Menu Bar Script Runners - Executes system scripts and displays their output directly in the macOS menu bar for real-time monitoring.
- Shell Script Interfaces - Provides a visual interface for running executable scripts and shell commands to trigger system actions.
- Incremental Menu Updates - Maintains open processes to update menu items in real-time as events occur without restarting scripts.
- Plugin Managers - Manages the lifecycle of plugins, including discovery from local folders and repository installations.
- Real-time Event Streams - Updates menu bar items in real-time via persistent background processes and event streams.
- Item Action Triggers - Executes shell scripts, opens links, or refreshes plugins upon selection of specific menu items.
- Interactive Dashboards - Renders real-time data and script results as interactive menu items and dropdowns on the desktop.
- Fixed Interval Schedulers - Refreshes menu bar items at fixed intervals or based on cron expressions defined in metadata.
- Directory-Based Plugin Discovery - Automatically discovers and imports executable plugins by scanning designated local directories.
- Dashboard Refresh Scheduling - Automates the periodic refreshing of menu bar status items using intervals or cron schedules.
- Real-Time Monitoring Systems - Tracks live data streams and system events using persistent background processes that update the menu bar.
- Status Monitors - Runs community-made or custom scripts on schedules to show live system and web information.
- Rich Text Formatting - Customizes menu entry appearance using parameters for colors, fonts, symbols, and markdown.
- Metadata-Driven Rendering - Uses script output parameters to dynamically control fonts, colors, and images in the menu bar.
- macOS Automation Tools - Provides a way to build personalized productivity tools by combining shell scripts and custom menu actions on macOS.
- MacOS Shortcut Runners - Integrates macOS Shortcuts by displaying their results directly in the system menu bar.
- Environment Variable Providers - Provides runtime system and metadata details via environment variables for conditional script logic.
- URL Scheme Handlers - Provides a custom URL scheme to trigger plugin updates and system notifications from external apps.
- Repository Plugin Installations - Enables browsing and installing pre-made script plugins from a built-in community repository.
- Embedded Web Views - Renders specific URLs as persistent or temporary interactive web views within the menu interface.
- Ephemeral Notifications - Generates temporary menu bar entries via URL schemes to display notifications and alerts.
- Menu Bar Tools - Powerful menu bar customization tool.
- Menu Bar Utilities - Listed in the “Menu Bar Utilities” section of the Awesome Mac awesome list.
- System Utilities - Turns script output into macOS menu bar items.
