taontech / spotter

🔎 macOS productivity tool to launch everything

Spotter

Productivity tool to launch everything (e.g. switch the next song, connect bluetooth device, set a timer, etc.) so you can stay focused on your current task.

• ❤️   Open source
• 🤖   Native
• 🔌   Plugin system
• ⌨️   Custom hotkeys
• ⬆️   Sort options by frequency of use
• 📦   Small size (less than 20mb)

Installation

brew install --cask spotter

Installation instructions and alternatives are available on https://spotter-application.github.io/getspotterapp

Hotkeys

Default hotkey to run the app double shift

Plugins

Bluetooth

• b <device_name>

Google

• g<space> (will get data from clipboard)
• g "your query"

System commands

• sleep
• shutdown
• restart
• logout

Kill applications

• k <app_name>

Applications dimensions

• save application positions
• restore application positions

Timer

• 15m

Spotify / Apple Music

• play
• pause
• next
• previous
• mute
• unmute
• share

Calculator

• cos(0)
• 256/8

Applications

• <app_name> (search by all installed applications)

The main idea

• 🔮   Provide an api on the native level
• ⚛️   React app uses it and implements various plugins

It will allow the application to remain native and be available for developing javascript/typescript plugins.

Contributing

After cloning & setting up the local project you can push the changes to your github fork and make a pull request.

Contributions are always welcome, no matter how large or small.

How to develop

React native requirements:

• Xcode version 11.3.1 or newer

• Ensure to install Xcode Command Line Tools. Open Xcode, then choose “Preferences…” from the Xcode menu. Go to the Locations panel and install the tools by selecting the most recent version in the Command Line Tools dropdown.

• Install CocoaPods sudo gem install cocoapods

• Install Node.js version 12 LTS or newer via HomeBrew brew install node

• Install Watchman brew install watchman

Project

• Clone repo git clone https://github.com/spotter-application/spotter.git

• Install node modules cd spotter && npm i

• Install pods npm run install:macos

• Run project npm start

Troubleshooting

The application “spotter” can’t be opened.

chmod +x "/Applications/spotter.app/Contents/MacOS/Spotter"

spotter can’t be opened because Apple cannot check it for malicious software.

Go to System Preference -> Privacity and Security -> General -> And Press "Open Anyway"

License

GNU General Public License