This is a basic app for Mac that integrates with Flic buttons.
The application allows you to execute your own scripts on Flic button presses. This requires OSX 10.10 or above operating systems running on a machine that supports Bluetooth Low Energy. It is unclear exactly which machines that have Bluetooth Low Energy support, but Apple supposedly started the transition around 2012. Running the following in a terminal will output the Bluetooth LMP Version:
system_profiler -detailLevel full SPBluetoothDataType | grep "LMP Version"
Version 0x6 was the first one that supported Low Energy, but we cannot guarantee that this will be correct for all computers. Using a Bluetooth Low Energy compatible USB dongle should also work if it is just configured correctly.
Since this application will blindly execute the scripts that you tell it to execute, it is very important that you make sure that you know what these scripts do. You need to verify, or have verified by someone who you trust, that the code being executed is not malicious in any way. We will not take responsibility for any harm that you may cause to your machine.
How it works
This application will allow you to connect multiple Flic buttons to your Mac computer and then select which scripts that you wish to execute on
Supported script files
The following files are supported:
- Automator workflows (
- All files that are executable (
chmod +x a_script.py) and contains a shebang on its first line (
Some examples of supported files:
- AppleScript -
- Shell Script -
- Ruby Script -
- Python Script -
This can of course vary a bit depending on how your Mac is configured.
- Download the repository by pressing the "Download ZIP" button.
- Mount the dmg file and drag and drop the HaxWithFlic.app to your applications folder.
- When launching the application from the applications folder the first time it will ask you if you want to open a file that was downloaded from the internet. Press open.
- Press on the flic icon in the menu bar and start using the application. For example, press scan if you want to add a new Flic.
- Press “Configure scripts..”.
- Add search paths to the scripts you want to launch.
Please note that some actions (like window resizing) requires that you add “HackWithFlic” to the accessibility list under the privacy settings of your mac. You can turn off the audio notifications by unchecking the "Play audio" option. If you are using the button for tasks that require very low latency then you can lower the latency by checking the "Low latency mode" option, but remember that this will decrease the battery life of your Flic significantly. The low latency mode reduces the latency down to 45ms from the normal 280ms. Notice, however, that these are worst case times and that the expected time is about half of that. The button down event always arrives before any other event, so it can be used for time critical applications.
We have added a few pre-made scripts that you can find in this repository. All of them are very small and should be self explanatory. If you have any cool scripts of your own that you believe could be useful to other people, then feel free to submit a pull request on this repository.
removeDuplicateLines.shGoes through your clipboard and removes all duplicate lines.
reverseLines.shGoes through your clipboard and reverses the characters on each line.
sortLines.shGoes through your clipboard and sorts all lines.
textToSpeech.shTakes the contents of your clipboard and plays it using text to speech.
interactiveScreenshot.shLets you select an area of your screen that you want to take a screenshot of. Resulting image is saved to your desktop folder.
maximizeApplicationWindow.shMaximizes the size of the frontmost window of the active application.
screenshot.shTakes a screenshot of your full desktop. Resulting image is saved to your desktop.
splitApplicationWindows.AppleScriptResizes the two frontmost windows of your active application and displays them side by side.
copyPathToClipboard.AppleScriptCopies the path of the selected item in your frontmost finder window to your clipboard.
moveSelectedFilesToFolder.AppleScriptLets you move the selected items in your frontmost finder window to a different location.
currentDateToClipboard.AppleScriptCopies the current time and date to your clipboard.
currentDateToClipboardAndPaste.AppleScriptSame as above but also pastes to your active application.
displayCurrentDateInDialog.AppleScriptDisplays a dialog window with the current time and date.
saveClipboardToFile.AppleScriptLets you save the contents of the clipboard to a new file at a location that you choose.
startCalculator.AppleScriptLaunches the Mac Calculator app.
displaysleep.shShuts down the display, system continues to run in the background. (Added by jonashoechst)
sleep.shPuts system to sleep, no network working anymore. (Added by jonashoechst)
chrome-CloseFrontWindow.AppleScriptCloses the frontmost chrome window. This closes all tabs in that window.
chrome-Reload.AppleScriptReload the selected tab of the frontmost chrome window.
chrome-ShowSourceFile.AppleScriptOpens a new tab showing the source code of the selected tab of the frontmost chrome window.
hue_switch.shToggle all your Philips Hue lights on/off. (Added by patricks)
hue_all_off.rbTurns off all lights. (Added by patricks)
hue_all_on.rbTurns on all lights. (Added by patricks)
hue_switch.rbSwitches the current state of all lights. (Added by patricks)
keynoteNextSlide.shDisplay next slide. This actually only simulates a keypress on the space key.
keynotePreviousSlide.shDisplay previous slide. This simulates a press on the p-key.
spotify-NextTrack.AppleScriptMoves to the next track. Also works with Spotify connect.
spotify-PlayPause.AppleScriptPlay or Pause the music. Also works with Spotify connect.
spotify-PreviousTrack.AppleScriptMoves to the previous track. Also works with Spotify connect.
pauseSpotifyAndSleep.shPauses Spotify if a track is currently playing and then puts mac to sleep. (Added by echo0101)
Notice: All Sonos scripts requires that you find the IP address of your Sonos and then change the script accordingly.
sonos-NextTrack.shSkip to next track in your current playing playlist.
sonos-Pause.shPause the playback.
sonos-Play.shPlay the previously paused playback.
sonos-PlayPauseToggle.shToggle between play and pause.
sonos-PreviousTrack.shSkip to the previous track in your current playing playlist.
vlc-NextPlaylistItem.AppleScriptJump to next item in playlist.
vlc-PreviousPlaylistItem.AppleScriptJump to previous item in playlist.
vlc-StepBackward.AppleScriptStep backward. Step length can be configured.
vlc-StepForward.AppleScriptStep forward. Step length can be configured.
vlc-StopPlayback.AppleScriptStop the current playback.
vlc-VolumeDown.AppleScriptDecrease volume by one step. Step length can be configured.
vlc-VolumeUp.AppleScriptIncrease volume by one step. Step length can be configured.