/CLI-Windows

Powershell based command line client for MediaButler

Primary LanguagePowerShell

MediaButler Windows CLI Utility

Codacy Badge Chat on Discord made-with-powershell

What is it?

A command line tool to enable usage of the MediaButler Server

Features

  • Can configure Sonarr/Radarr/Tautulli for use with the Server
  • Add and Manage Requests
  • Add and Manage Issues
  • Media Search
  • Retrieve currently playing statistics
  • Playback History

Why do you need my Plex username and password?

As the Server only supports authenticated forms of communication, we require this information to perform an authentication with Plex. This information is used ONLY to perform Plex authencation and is not saved. We do however save a resulting token that is unique that is saved so you do not have to perform authentication again.

Requirements

We have done everything in our power to limit the dependancies this application has and for most users, it should have it installed. However in case you do not you will require the following:

  • PowerShell 5 or later - PowerShell 5 is available for Windows 7 and up.

or

  • PowerShell Core

Installing and Using

The simplest method would be to either download the file manually or cloning this git repository.

 git clone https://github.com/MediaButler/CLI-Windows.git

Windows (PowerShell >= 5) Users

Please be warned that by default Windows Policies are to block any and all scripts that are not made directly on your machine. We need to make a few changes in order to get windows to accept the script. This can be done by opening an Administrative PowerShell prompt and running the following commands:

Set-ExecutionPolicy RemoteSigned
// Select Yes to the warning that it gives you.
cd C:\path\to\CLI-Windows
Unblock-File .\mediabutler.ps1

This only needs to be performed once.

You can also start PowerShell in exception mode for this specific file by running PowerShell.exe -ExecutionPolicy RemoteSigned -File C:\path\to\CLI-Windows\mediabutler.ps1

Using

Running can be done by opening a PowerShell prompt and running the following:

cd C:\path\to\CLI-Windows
.\mediabutler.ps1

Docker

You can also run the client inside a docker envrionment by running

docker run -it mediabutler/cli-windows

Support

Further help and support using this script can be found in our Wiki or drop by our Discord Server