https://badges.gitter.im/howdy/community.svg https://readthedocs.org/projects/howdy/badge/?version=latest

howdy_icon
Howdy! - Yet Another Way to Manage Your Plex Server’s Content

Howdy! (previously Plexstuff) is a (hopefully) useful SDK that I have developed to manage the movies, television shows, and music in which I am interested. I hope that it is, or becomes, a worthy member of the rich community of services used to manage one’s media.

Here are a few of the best known high level media management services:

Here are some of the best known lower APIs used to help one manage your Plex server.

  • Tautulli to monitor your Plex server.
  • Jackett is a relatively successful proxy server that consolidates the torrent search from a large number of public, private, and semi-private torrent trackers and services into a single search user interface and API.
  • PlexAPI is the unofficial bindings to the Plex API. They are based off the older unofficial Plex API. I still use the unofficial Plex API because it seems to offer more freedom (such as finer grained multithreaded HTTP requests, and access to remote servers) than PlexAPI.

The command line tools are built using Python’s ArgumentParser object, and the GUIs are built with PyQt5.

The comprehensive documentation lives in HTML created with Sphinx, and now in the Read the Docs page for this project. To generate the documentation,

  1. go to the docs subdirectory.
  2. In that directory, run make html.
  3. Load docs/build/html/index.html into a browser to see the documentation.

Quick and Dirty – How Do I Get It Working?

Although discussed in the Sphinx documentation, to get everything working you need sshpass and PyQt5. Getting all this on Linux machines is probably more straightforward than on Macs and Windows machines.

To be able to use all the CLIs, GUIs, and API functionality, there are 12 sets of configurations that need to work: four for login, four for credentials, and four for music.

main_config_gui login_config_gui credentials_config_gui music_config_gui
12 total settings 4 login settings 4 credential settings 4 music settings

What Are Some Interesting Command Line Executables?

You can try out howdy_music_songs to get individual songs or all the songs in an artist’s studio album, or howdy_music_album to find all the studio albums an artist released. Here are three YouTube clips that show howdy_music_songs in action.

howdy_music_songs_clip1 howdy_music_songs_clip2 howdy_music_songs_clip3
Download artists & songs Download artist & album Download sep artists & songs

TODO

Here are some things I would like to finish.

  • Fill out documentation for all the CLIs (☑) and GUIs (finished except for howdy_tv_gui and howdy_movie_totgui).

  • Fill out documentation for the lower level APIs (☑).

  • Setup-ify this repository as a howdy Python module (☑).

  • Fill out help dialogs for the GUIs.

  • Complete the testing suite.

  • Streamline the OAuth2 authentication process, and provide more logical authorization and verification work flows.

    Note

    I don’t know how to do this.

  • Transition GUIs to use PyQt5 (☑), with the eventual use of fbs.

    Note

    Actually, the fbs website says that fbs supports only Python 3.5 and 3.6. That’s a dealbreaker!