Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
/ devbar Public

Boost your development workflow directly from the macOS Menu Bar. The all-in-one tool for automation, monitoring, and script management.

License

Notifications You must be signed in to change notification settings

antlss/devbar

Repository files navigation

DevBar

Your scripts, always one click away.

A powerful macOS Menu Bar application for developers to manage scripts, monitor processes, and automate tasks.

macOS 13.0+ Swift 5.9 License: MIT

FeaturesInstallationUsageScreenshotsContributing


✨ Features

Feature Description
🚀 Script Management Create, organize, and execute shell scripts directly from the menu bar
📊 Process Monitoring Real-time monitoring of running services with live log streaming
Task Scheduling Schedule scripts with cron expressions, intervals, or one-time execution
🔌 Port Scanner Automatically detect and manage listening ports on your machine
🎨 Dashboard View Full-featured dashboard window for detailed script and schedule management
🔔 Smart Notifications Desktop notifications for scheduled task completion and failures

📦 Installation

Download (Recommended)

  1. Download the latest DevBar.dmg from Releases

  2. Install — Open the DMG and drag DevBar to Applications:

    Installer

  3. First Launch — Handle macOS security warning:

    ⚠️ Since DevBar is not notarized, macOS Gatekeeper will block it on first launch.

    • Double-click DevBar in Applications
    • Click "Cancel" on the security warning
    • Open System Settings → Privacy & Security
    • Find the DevBar message and click "Open Anyway"
    • Click "Open" to confirm
  4. Grant Permissions — DevBar requires these permissions:

    Permission How to Enable Why It's Needed
    Full Disk Access System Settings → Privacy & Security → Full Disk Access → Enable DevBar Run scripts and access logs in any directory
    Notifications System Settings → Notifications → DevBar → Allow Receive alerts for scheduled tasks
    Automation (optional) System Settings → Privacy & Security → Automation Open apps like VSCode, Terminal

Build from Source

Click to expand build instructions

Prerequisites: Xcode 15.0+, XcodeGen (optional)

# Clone
git clone https://github.com/antlss/devbar.git
cd devbar
# Generate project (if using XcodeGen)
xcodegen generate
# Open and build
open DevBar.xcodeproj
# Press ⌘R to build and run

🚀 Usage

Quick Start

  1. Click the DevBar icon in your menu bar
  2. Add your first script via the popup or Dashboard
  3. Run scripts with a single click
  4. Schedule recurring tasks with cron, interval, or one-time triggers

Menu Bar Popup

Menu Bar Popup

Access everything in one click:

  • Scripts — Run any script instantly
  • Running Services — Monitor active processes
  • Tools — Quick launch VSCode, Docker, Terminal
  • Settings — Configure preferences

Dashboard

Open the full Dashboard for advanced features:

  • Script Editor — Edit scripts with syntax highlighting
  • Schedule Manager — Visual cron builder and scheduling
  • Execution History — View logs and past runs
  • Settings — Customize appearance and behavior

📸 Screenshots

Menu Bar Popup
Scripts Running Services Tools Settings
Dashboard Window
Scripts Management Execution History
Scripts History
Schedule Editor Running Services
Schedule Services
Schedule Types
Cron Expression Interval One-time
Cron Interval Once
Settings

Settings


💻 Requirements

Requirement Minimum Version
macOS 13.0 (Ventura)
Xcode 15.0 (for building)

⚙️ Configuration

All data is stored in ~/Library/Application Support/DevBar/:

DevBar/
├── scripts.json # Script configurations
├── schedules.json # Schedule configurations
├── user_settings.json # User preferences
└── logs/ # Execution logs

🔧 Troubleshooting

App won't open — "DevBar is damaged"

Run this command to remove the quarantine flag:

xattr -cr /Applications/DevBar.app
Scripts not running
  1. Ensure Full Disk Access is enabled for DevBar
  2. Check the script path and permissions
  3. View execution logs in Dashboard → History
Notifications not appearing

Go to System Settings → Notifications → DevBar and enable notifications.


📁 Project Structure

DevBar/
├── App/ # Application entry points
│ ├── DevBarApp.swift
│ ├── AppDelegate.swift
│ └── AppState.swift # Centralized state management
├── Models/ # Data models
├── Views/
│ ├── Dashboard/ # Dashboard window views
│ ├── MenuBar/ # Menu bar popup views
│ └── Components/ # Reusable UI components
├── Services/
│ ├── Execution/ # Process spawning & management
│ ├── Scheduling/ # Task scheduling
│ ├── Storage/ # JSON persistence
│ └── System/ # System tools integration
└── Supporting/ # Extensions & utilities

🔨 Building for Release

# Archive
xcodebuild -project DevBar.xcodeproj \
 -scheme DevBar \
 -configuration Release \
 -archivePath build/DevBar.xcarchive \
 archive
# Export
xcodebuild -exportArchive \
 -archivePath build/DevBar.xcarchive \
 -exportPath build/release \
 -exportOptionsPlist ExportOptions.plist

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

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


🙏 Acknowledgments


Made with ❤️ for developers

AltStyle によって変換されたページ (->オリジナル) /