https://github.com/othyn/macos-jockey
macOS menu bar app that keeps your SMB network shares mounted, as macOS loves to eject them all the time!
https://github.com/othyn/macos-jockey
macos macos-app sequoia smb sonoma
Last synced: about 2 months ago
JSON representation
macOS menu bar app that keeps your SMB network shares mounted, as macOS loves to eject them all the time!
- Host: GitHub
- URL: https://github.com/othyn/macos-jockey
- Owner: othyn
- License: mit
- Created: 2025-03-26T22:04:20.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-02T12:24:51.000Z (about 1 year ago)
- Last Synced: 2025-04-02T13:29:19.119Z (about 1 year ago)
- Topics: macos, macos-app, sequoia, smb, sonoma
- Language: Swift
- Homepage:
- Size: 1.61 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Jockey for macOS
A simple SMB (Samba) mount keep-alive menu bar app for macOS Sequoia (15) built with ♥️ in Swift & SwiftUI.
# :notebook_with_decorative_cover: Table of Contents
- [About the Project](#star2-about-the-project)
- [Screenshot](#camera-screenshot)
- [Tech Stack](#space_invader-tech-stack)
- [Features](#dart-features)
- [Download](#floppy_disk-download)
- [Contributing](#memo-contributing)
- [Changelog](https://github.com/othyn/macos-jockey/releases)
- [License](#warning-license)
- [Acknowledgements](#gem-acknowledgements)
## :star2: 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](https://www.pixeleyes.co.nz/automounter/).
### :camera: Screenshot
### :space_invader: Tech Stack
- Swift
- Swift UI
### :dart: 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
## :floppy_disk: Download
**Download for macOS Sequoia (15) and higher:** [v1.0.6](https://github.com/othyn/macos-jockey/releases/download/v1.0.6/Jockey.zip)
### 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.
## :memo: Contributing
See the [contribution guide](CONTRIBUTING.md) 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.
## :warning: License
Distributed under the MIT License. See [LICENSE](https://github.com/othyn/macos-jockey/blob/main/LICENSE) for more information.
## :gem: Acknowledgements
Useful resources and libraries that have been used in the making of this project.
- Readme: [shields.io](https://shields.io/)
- Readme: [ikatyang/emoji-cheat-sheet](https://github.com/ikatyang/emoji-cheat-sheet)
- Readme: [Louis3797/awesome-readme-template](https://github.com/Louis3797/awesome-readme-template)