Skip to main content

Cast All The Things allows you to send videos from many, many online sources to your Chromecast.

Project description

https://img.shields.io/pypi/v/catt.svg https://img.shields.io/travis/skorokithakis/catt.svg https://badges.gitter.im/Join%20Chat.svg

Cast All The Things allows you to send videos from many, many online sources (YouTube, Vimeo, and a few hundred others) to your Chromecast. It also allows you to cast local files or render websites.

Installation

You can install Cast All The Things with pip:

pip install catt

catt is only compatible with Python 3. If you need a Python 2-compatible version, please install 0.5.6, the last py2-compatible release.

Usage

To use Cast All The Things, just specify a URL:

catt cast "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

catt supports any service that youtube-dl supports, which includes most online video hosting services.

catt can also cast local files (if they’re in a format the Chromecast supports natively):

catt cast ./myvideo.mp4

You can also control your Chromecast through catt commands, for example with catt pause. Try running catt --help to see the full list of commands.

If you have subtitles and the name is similar to the name of the local file, catt will add them automatically. You can, of course, specify any other subtitle if you want. Although Chromecast only supports WEBVTT, TTML and Line 21 subtitles, catt conveniently converts SRTs to WEBVTT for you on the fly. Here is how to use it:

catt cast -s ./mysubtitle.srt /myvideo.mp4

catt can also tell your Chromecast to display any website:

catt cast_site https://en.wikipedia.org/wiki/Rickrolling

Please note that the Chromecast has a slow CPU but a reasonably recent version of Google Chrome. The display resolution is 1280x720.

Configuration file

CATT can utilize a config-file stored at ~/.config/catt/catt.cfg (%APPDATA%\catt\catt.cfg on Windows).

The format is as following:

[options]
device = chromecast_one

[aliases]
one = chromecast_one
two = chromecast_two

In the [options] section, device denotes the default device that will be selected, when you have not selected a device via the cli.

You can write your choice of default device to catt.cfg by doing:

catt -d <name_of_chromecast> write_config

In the [aliases] section, you can specify aliases for the names of your chromecasts. You can then select a device just by doing:

catt -d <alias> <command>

Currently, in order to take advantage of this functionality, you need to manually edit catt.cfg

Contributing

If you want to contribute a feature to catt, please open an issue (or comment on an existing one) first, to make sure it’s something that the maintainers are interested in. Afterwards, just clone the repository and hack away!

To run catt in development, you can use the following command:

python -m catt.cli --help

Before committing, please make sure you install pre-commit and install its hooks:

pip install pre-commit
pre-commit install

That’s all, now you can commit and the hooks will run. Black (which is used to format the code) requires Python 3.6 to run, but please make the effort, as our CI will yell at you if the code is not formatted, and nobody wants that.

Thanks!

Info

  • Free software: BSD license

Features

  • Casts videos to Chromecast.

  • From many, many online sources.

  • Casts local files (videos, photos and music)

  • Casts any website to Chromecast

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

catt-0.8.1.tar.gz (23.1 kB view details)

Uploaded Source

Built Distribution

catt-0.8.1-py2.py3-none-any.whl (21.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file catt-0.8.1.tar.gz.

File metadata

  • Download URL: catt-0.8.1.tar.gz
  • Upload date:
  • Size: 23.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.9.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3

File hashes

Hashes for catt-0.8.1.tar.gz
Algorithm Hash digest
SHA256 344dea39e4833d6ccbd39a10b38d2ad3aa339b455a47e650d1ac1a2ca8787427
MD5 95afea122dbb05d1b5a7b37e554aeea4
BLAKE2b-256 7e1aa0bf8f7de534ea36364a52aa26d9ae7909e39d5450f52d410fd7f3bcbf8d

See more details on using hashes here.

File details

Details for the file catt-0.8.1-py2.py3-none-any.whl.

File metadata

  • Download URL: catt-0.8.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 21.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.9.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3

File hashes

Hashes for catt-0.8.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8d7fe135dd6d7224f2b5d2cc42e401f1b21df2da0a4e03555d87e0d367bf55b8
MD5 771a89eb03e26ddc2f664228f20a7575
BLAKE2b-256 5bc7f4fd6b7289ad73f24ef27a3ff399d8ec2ff70b20f152a233f35979fd43cd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page