Jockey for macOS

A simple SMB (Samba) mount keep-alive menu bar app for macOS Sequoia (15) built with ♥️ in Swift & SwiftUI.

Download Latest Version · Report a Bug · Request a Feature

📔 Table of Contents

• About the Project
  • Screenshot
  • Tech Stack
  • Features
• Download
• Contributing
• Changelog
• License
• Acknowledgements

🌟 About the Project

Jockey is a macOS menu bar utility that helps keep your SMB network shares mounted and connected, preventing the common issue of disconnections that can disrupt your workflow, or that aggravating 'Unavailable' on Plex when you've just got into bed.

Designed as an Open Source alternative to AutoMounter.

📷 Screenshot

👾 Tech Stack

• Swift
• Swift UI

🎯 Features

• Menu Bar Integration: Runs efficiently in the menu bar with minimal resource usage
• Connection Status: Shows connection status and uptime for all configured shares
• Auto-reconnect: Automatically attempts to reconnect shares when they disconnect
• Configurable Polling: Set how frequently Jockey checks connection status
• Custom Mount Points: Configure shares with specific mount points
• System Integration: Detects existing system SMB mounts

Usage

1. Launch Jockey, and it will appear in your menu bar
2. Click the menu bar icon to see the status of your shares
3. Open Settings to add or manage SMB shares
4. Adjust the polling interval to control how often Jockey checks your connections
5. Accept the prompt to allow Finder permissions, as is required to allow Jockey to mount shares on your behalf

💾 Download

Download for macOS Sequoia (15) and higher: v1.0.6

Using the app for the first time

When first using the app, you will need to right click the app and click 'Open', then on the macOS popup window select 'Open' again to trust this version of the app going forward. This is as at the moment I don't have a paid Apple developer account in order to notarize the app.

First time use for macOS Sequoia (15) users

If you are using macOS Sequoia, there are increased barriers in place to stop you running un-notarized apps. To open the app you will need to do the following;

1. Try to open the app, and when presented with the options to 'Move to trash' or otherwise, close out of that prompt:

2. Head over to System Settings > Privacy & Security > Security, and scroll all the way at the bottom, you should see the following:

3. Click on the 'Open Anyway' button.
4. When prompted with the following dialogue, click 'Open Anyway':

5. Head back to the Jockey app and try opening it again, it should now work as normal.
6. When Jockey first attempts to mount a share, it will pop-up and prompt for Finder access, which you will need to grant in order for Jockey to mount shares in your behalf.
   • Alternatively, you can grant Jockey 'Full Disk Access' within System Settings > Privacy & Security, but I will leave that down to your best judgement.

📝 Contributing

See the contribution guide on how to get started. Thank you for contributing!

Detailed within that guide are steps on how...

• ... issues should be used.
• ... to setup the project.
• ... to contribute new languages via the app's localisation support.
• ... branches should be used.
• ... commits should be formatted.
• ... pull requests should be submitted.
• ... the build process works and the automation that drives it.

⚠️ License

Distributed under the MIT License. See LICENSE for more information.

💎 Acknowledgements

Useful resources and libraries that have been used in the making of this project.

• Readme: shields.io
• Readme: ikatyang/emoji-cheat-sheet
• Readme: Louis3797/awesome-readme-template