Create a menubar app for macOS, just using Python
Introduction
While Python is great for building a lot of things, macOS apps are certainly not one of them. I was wondering if its possible to build a menu bar app for macOS using Python. I found out that its not only possible its ridiculously uncomplicated.
In this tutorial, well be building a realtime macOS app for stock prices all using Python.
Lets start by installing the dependencies.
rumpsrequestspy2app
Rumps
Rumps generates PyObjC apps (specifically menubar apps) from simple python code. To test the rumps module, run the following code:
import rumpsdef hello(sender): print(f"Hello from {sender.title}")app = rumps.App("Hello World")app.menu = [rumps.MenuItem("Weird Menu Item",callback=hello)]app.run()
The hello()
function is executed when the menu item is clicked.
>>> Hello from Weird Menu Item
To add more menu items, we can just add more elements to the app.menu list. The argument sender represents the MenuItem that has set the callback.
A cleaner way to get the same result is by using rumps.clicked
decorator:
@rumps.clicked("Weird Menu Item")@rumps.clicked("Saner Menu Item")def hello(sender): print(f"Hello from {sender.title}")app = rumps.App("Hello World")app.run()
We will stick to the decorators approach for rest of the tutorial.
Stock price data
There are many sources to get stock quotes. We will be using Finnhubs API (auth key based, free to use).
GET https://finnhub.io/api/v1/quote?symbol=AAPL&token=YOUR_API_KEY
Sample response:
{ "c":119.49, "h":119.6717, "l":117.87, "o":119.44, "pc":119.21, "t":1605436627}
You can register at https://finnhub.io/register for a free API key. At the time of writing this the rate limit is 60 requests/minute.
Building the StockApp
Initiate a class named StockApp as a subclass of rumps.App class, and add some menu items using the rumps.clicked decorator:
import rumpsclass StockApp(rumps.App): def __init__(self): super(StockApp, self).__init__(name="Stock") @rumps.clicked("MSFT") @rumps.clicked("AAPL") def getStock(self, sender): self.title = f"{sender.title}"if __name__ == '__main__': StockApp().run()
Now its time to integrate StockApp with Finnhub API. Lets tweak getStock() like this:
import requestsimport rumpsclass StockApp(rumps.App): def __init__(self): super(StockApp, self).__init__(name="Stock") @rumps.clicked("MSFT") @rumps.clicked("AAPL") def getStock(self, sender): response = requests.get(f"https://finnhub.io/api/v1/quote?symbol={sender.title}&token=YOUR_API_KEY") stock_data = response.json()['c'] self.title = f"{sender.title}:{stock_data}"if __name__ == '__main__': StockApp().run()
The getStock()
method updates the title when you select a stock symbol from the menu.
However, we dont want to get the price by a click event. We need a function to continuously update the price of the selected stock, say after every few seconds.
To do this rumps has a Timer
class, and you can decorate a function with rumps.timer()
to set a timer on the function.
@rumps.timer(1)def do_something(self, sender): # this function is executed every 1 second
At the launch, we can set some default menu item, say AAPL. This option can be changed with a click event while the timer-decorated function will keep updating the price for the currently selected menu item.
@rumps.clicked("AAPL")@rumps.clicked("MSFT")def changeStock(self, sender): self.stock = sender.title@rumps.timer(5)def updateStockPrice(self, sender): # fetch stock quote and update title
Not to complicate this but since the app will be sending network requests, wed need to handle API requests on a different thread so the app UI keeps running while the request is in process.
import threading@rumps.timer(5)def updateStockPrice(self, sender): thread = threading.Thread(target=self.getStock) thread.start()def getStock(self): # code to send API request
Putting it all together
Heres how it will look at full implementation. We have added icons, made the title more catchy, and added a functionality for user input (using rumps.Window).
import threadingimport requestsimport rumpsclass StockApp(rumps.App): def __init__(self): super(StockApp, self).__init__(name="Stock") self.stock = "AAPL" self.icon = "icon.png" self.API_KEY = "YOUR_API_KEY" @rumps.clicked("Search...") @rumps.clicked("MSFT") @rumps.clicked("TSLA") @rumps.clicked("NFLX") @rumps.clicked("FB") @rumps.clicked("AAPL") def changeStock(self, sender): if sender.title!="Search...": self.title = f" {sender.title}" self.stock = sender.title else: # Launches a rumps window for user input window = rumps.Window(f"Current: {self.stock}","Search another stock") window.icon = self.icon response = window.run() self.stock = response.text @rumps.timer(5) def updateStockPrice(self, sender): thread = threading.Thread(target=self.getStock) thread.start() def getStock(self): response = requests.get(f"https://finnhub.io/api/v1/quote?symbol={self.stock}&token={self.API_KEY}") if response.status_code!=200: self.title = "API Error." return stock_data = response.json() current_price = stock_data['c'] previous_close = stock_data['pc'] change = current_price-previous_close try: changePercentage = abs(round(100*(change/previous_close), 2)) if change<0: marker = "" else: marker = "" self.title = f" {self.stock}: {str(response.json()['c'])} {marker}{changePercentage}%" # Finnhub returns 0 for non-existent symbols except ZeroDivisionError: self.title = "Invalid symbol, set to AAPL" self.stock = "AAPL"if __name__ == '__main__': StockApp().run()
To run the app you will need to have an icon.png file in the same directory. You can download it from the links below or else just remove the icon from the program. Also, dont forget to assign your Finnhub API key to self.API_KEY
.
Download icon.png
Download icon.icns
Converting it to .app
Now that the app is ready, we just need to generate a shippable macOS app. We can use py2app to do this.
You need to have a setup.py file in the same directory. Other than that you can also add an icon for your application. macOS app icons have the file type .icns
StockApp |__ app.py |__ setup.py |__ icon.png |__ icon.icns
The setup.py file:
from setuptools import setupAPP = ['app.py']DATA_FILES = ['icon.png']OPTIONS = { 'argv_emulation': True, 'iconfile': 'icon.icns', 'plist': { 'CFBundleShortVersionString': '1.0.0', 'LSUIElement': True, }, 'packages': ['rumps','requests']}setup( app=APP, name='Stock', data_files=DATA_FILES, options={'py2app': OPTIONS}, setup_requires=['py2app'], install_requires=['rumps','requests'])
Finally run the setup:
python setup.py py2app
You can find your in the newly-created dist
folder. Open the app, and see it in action!
If you are getting an error at the runtime, launch the app via terminal so you can go through the traceback.
open Stock.App/Contents/MacOS/Stock
Conclusion
As we have seen its easy to create simple menu bar apps like this. A whole lot of things can be built on top of this as it gives you the power to trigger Python functions so easily. We can make a music controller, a server monitor, to see if a program is running, stopwatch, CPU meters, flight position trackers, Internet speed tests, just to name a few.
Further Readings and At)tributions:
Original Link: https://dev.to/adarshpunj/create-a-menubar-app-for-macos-just-using-python-hmp
Dev To
An online community for sharing and discovering great ideas, having debates, and making friendsMore About this Source Visit Dev To