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
• 🔌   Plugins
• ⌨️   Custom hotkeys
• ⬆️   Sort options by frequency of use
• 📦   Small size

💬 Community

telegram channel

Usage

Installation

brew install --cask spotter

Default hotkey to run the app double shift

Plugins

Applications

• <app_name>

Bluetooth

• bluetooth
• <device_name>

Currency converter

• 1 usd
• 100 euro in usd

System commands

• sleep
• shutdown
• restart
• logout

Timer

• 15m

Emoji

• e rocket

Kill applications

• <app_name> <tab> close

Applications dimensions

• save application positions
• restore application positions

Spotify

• spotify <tab> play
• spotify <tab> pause
• spotify <tab> next
• spotify <tab> previous
• spotify <tab> mute
• spotify <tab> unmute
• spotify <tab> share

Calculator

• 256/8
• 256*8=

Browser

• github.com

Pass

• p email/gmail

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.

Requirements

• macOS Big Sur

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

"spotter.app" is damaged and can’t be opened.

xattr -cr /Applications/spotter.app

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 -> Security & Privacy -> General -> And Press "Open Anyway"

License

GNU General Public License