<commit_before># Stagehand

**Danger!  This software is half-baked. At the moment, it only works with
[Easynews](http://easynews.com). It's not released yet. If you want to try it,
expect some pain.**


## What it is

Stagehand is a manager for your favourite TV series.  It automatically
downloads new episodes of the TV shows in your library, and provides a convenient
interface to download previously aired episodes.

Here are some of the main features:

* Pretty, modern-looking UI
* Support for multiple TV metadata providers (currently TheTVDB and TVRage): easily choose the authoritative provider per-series
* A Just Works design principle: no cumbersome setup or external tools
* Support for Easynews HTTP-based global search



## What it isn't (yet)

The core of Stagehand is quite robust, but many essential features are missing
(but planned):

* NZB and NNTP support (for non-Easynews Usenet services): the most critical missing functionality
* Bittorrent
* Web-based configuration UI
* Ability to import an existing TV library
* Multi-platform: it is Linux-only right now
* ... and a bazillion FIXMEs and TODOs in the source



## What it looks like

![](https://helix.urandom.ca/stagehand/stagehand.jpg)

![](https://helix.urandom.ca/stagehand/stagehand2.jpg)


## How to install it

Stagehand is Linux software.

Assuming your distro has a relatively recent version of pip (0.5 or later),
installation should be fairly straightforward:

This is what's needed for Ubuntu or Debian.  Adapt as needed to your distro.

```bash
# Install base dependencies
$ sudo apt-get install python-dev python-beautifulsoup python-pycurl python-pip libglib2.0-dev git-core

# Install kaa-base and kaa-metadata from git
$ sudo pip install -U git+git://github.com/freevo/kaa-base.git git+git://github.com/freevo/kaa-metadata.git

# Install Stagehand from git
$ sudo pip install -U --no-deps git+git://github.com/jtackaberry/stagehand.git
```

Once installed, run it:

```bash
$ stagehand -vv
```

It will output a line that looks like:

```<commit_msg>Include libdvdread-dvd package in installation instructions<commit_after># Stagehand

**Danger!  This software is half-baked. At the moment, it only works with
[Easynews](http://easynews.com). It's not released yet. If you want to try it,
expect some pain.**


## What it is

Stagehand is a manager for your favourite TV series.  It automatically
downloads new episodes of the TV shows in your library, and provides a convenient
interface to download previously aired episodes.

Here are some of the main features:

* Pretty, modern-looking UI
* Support for multiple TV metadata providers (currently TheTVDB and TVRage): easily choose the authoritative provider per-series
* A Just Works design principle: no cumbersome setup or external tools
* Support for Easynews HTTP-based global search



## What it isn't (yet)

The core of Stagehand is quite robust, but many essential features are missing
(but planned):

* NZB and NNTP support (for non-Easynews Usenet services): the most critical missing functionality
* Bittorrent
* Web-based configuration UI
* Ability to import an existing TV library
* Multi-platform: it is Linux-only right now
* ... and a bazillion FIXMEs and TODOs in the source



## What it looks like

![](https://helix.urandom.ca/stagehand/stagehand.jpg)

![](https://helix.urandom.ca/stagehand/stagehand2.jpg)


## How to install it

Stagehand is Linux software.

Assuming your distro has a relatively recent version of pip (0.5 or later),
installation should be fairly straightforward:

This is what's needed for Ubuntu or Debian.  Adapt as needed to your distro.

```bash
# Install base dependencies
$ sudo apt-get install python-dev python-beautifulsoup python-pycurl python-pip libglib2.0-dev libdvdread-dev git-core

# Install kaa-base and kaa-metadata from git
$ sudo pip install -U git+git://github.com/freevo/kaa-base.git git+git://github.com/freevo/kaa-metadata.git

# Install Stagehand from git
$ sudo pip install -U --no-deps git+git://github.com/jtackaberry/stagehand.git
```

Once installed, run it:

```bash
$ stagehand -vv
```

It will output a line that looks like:

```
{'fraction_non_alphanumeric': 0.08471720818291216, 'fraction_numerical': 0.0024067388688327317, 'mean_word_length': 4.294267515923567, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1234515', 'n_tokens_mistral': 1258, 'n_tokens_neox': 1177, 'n_words': 524}