Skip to content

david-kuehn/casita

Repository files navigation

Casita

A macOS menubar app used to control media playing on Google Home, Chromecast, and other Cast-enabled devices.

Details

  • Lightweight footprint
    • App size is ~20MB
    • Energy impact always hovers around 0.0, according to Activity Monitor
    • Uses ~30MB of RAM
    • Uses virtually no CPU resources
  • Works with nearly all Cast-enabled devices—even those not made by Google
  • No configuration needed, just start the app and control your media

Technologies

Installing Casita

Download the App

First, download and unzip the latest release.

Casita is not officially signed by Apple, meaning that there are a few extra steps in order to be able to run it:

  1. You MUST move the application to your Applications folder in order for it to run. This is due to Apple's translocation of unsigned apps.
  2. Control-click on the app, and choose "Open."
  3. In the alert that appears, if you see an option to open, select it, and Casita should open! Otherwise, choose "Cancel" and proceed to the next step.
  4. Control-click on the app again, choose "Open," and a new alert should appear that gives you an option to open the app.

After getting the app to open once, you shouldn't have any more problems in the future. Please refer to Apple's documentation for further reference.

Manually Building the macOS App

  1. Install all the dependencies from requirements.txt.
    • pip install -r requirements.txt
  2. In the project's root directory, build the app using py2app.
    • python3 setup.py py2app --arch=universal2
  3. The newly-generated application can be found in the dist directory.
    • Run the generated macOS app!

Running Uncompiled from Terminal

  1. Run the command python3 casita/casita.py.
    • This can be run with the --debug flag to enable rumps debug mode, which gives some extra output corresponding to UI interaction.
  2. To quit, use the 'Quit' button in the app's UI, or close the terminal instance.

Upcoming Features

A list of planned features can be found here. Feel free to leave comments on the Notion page to suggest new features and comment on features that are already in the pipeline.