# Terminalcast
Command line tool to cast local video files to your chromecast.
Inspired by https://github.com/keredson/gnomecast
## Supported media types
Checkout https://developers.google.com/cast/docs/media for your Chromecast model.
Use ffmpeg to convert unsupported files to a supported format:
```commandline
ffmpeg -i '{input_file}' -metadata title="{title}" -map 0 -c:v {video_codec} -c:a {audio_codec} -c:s copy '{output_file}'
```
## Supported Chromecast versions
In principle this should work with any Chromecast which is supported by https://github.com/home-assistant-libs/pychromecast.
In practice, I discovered that a Chromecast with Google TV enables you to control the player via the remote control, which is very nice.
## Installation
```commandline
pip install terminalcast
```
## How is it working?
**Terminalcast** creates a little HTTP Server at your current machine and serves your media file there. Then it tells the
Chromecast the play the stream served at your IP with the corresponding path. That's it! (The devil is in the details.)
**Terminalcast** uses [Bottle](https://bottlepy.org/docs/dev/) to create a small app providing the media file. This app is
served by [Paste](https://pypi.org/project/Paste/).
On the other hand **Terminalcast** detects and plays the media via [PyChromecast](https://pypi.org/project/PyChromecast/).
For file information and conversion [ffmpeg-python](https://pypi.org/project/ffmpeg-python/) is used.
Raw data
{
"_id": null,
"home_page": "https://github.com/vanadinit/terminalcast",
"name": "terminalcast",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "Chromecast,video,local,movie",
"author": "Johannes Paul",
"author_email": "vanadinit@quantentunnel.de",
"download_url": "https://files.pythonhosted.org/packages/78/8f/fec9bbf90771a0b90a2ac5fefb992519a364413014609041082cb0b07972/terminalcast-1.0.0.tar.gz",
"platform": null,
"description": "# Terminalcast\n\nCommand line tool to cast local video files to your chromecast.\n\nInspired by https://github.com/keredson/gnomecast\n\n## Supported media types\nCheckout https://developers.google.com/cast/docs/media for your Chromecast model.\n\nUse ffmpeg to convert unsupported files to a supported format:\n```commandline\nffmpeg -i '{input_file}' -metadata title=\"{title}\" -map 0 -c:v {video_codec} -c:a {audio_codec} -c:s copy '{output_file}'\n```\n\n## Supported Chromecast versions\nIn principle this should work with any Chromecast which is supported by https://github.com/home-assistant-libs/pychromecast.\n\nIn practice, I discovered that a Chromecast with Google TV enables you to control the player via the remote control, which is very nice.\n\n## Installation\n```commandline\npip install terminalcast\n```\n\n## How is it working?\n**Terminalcast** creates a little HTTP Server at your current machine and serves your media file there. Then it tells the\nChromecast the play the stream served at your IP with the corresponding path. That's it! (The devil is in the details.)\n\n**Terminalcast** uses [Bottle](https://bottlepy.org/docs/dev/) to create a small app providing the media file. This app is\nserved by [Paste](https://pypi.org/project/Paste/).\n\nOn the other hand **Terminalcast** detects and plays the media via [PyChromecast](https://pypi.org/project/PyChromecast/).\n\nFor file information and conversion [ffmpeg-python](https://pypi.org/project/ffmpeg-python/) is used.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Cast local videos to your chromecast",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/vanadinit/terminalcast"
},
"split_keywords": [
"chromecast",
"video",
"local",
"movie"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9f11b28533ea3e3e9f31ac88941078abbe9fde393849b6d2d0ece1fc3cfd87fe",
"md5": "801773905bd7d5a68773b10e38dde3c4",
"sha256": "7812102311c6af61649ab3f9432cf16e05ecd37048f5bd5cfc733734bd9d1ab8"
},
"downloads": -1,
"filename": "terminalcast-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "801773905bd7d5a68773b10e38dde3c4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 6979,
"upload_time": "2023-09-26T18:48:37",
"upload_time_iso_8601": "2023-09-26T18:48:37.662558Z",
"url": "https://files.pythonhosted.org/packages/9f/11/b28533ea3e3e9f31ac88941078abbe9fde393849b6d2d0ece1fc3cfd87fe/terminalcast-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "788ffec9bbf90771a0b90a2ac5fefb992519a364413014609041082cb0b07972",
"md5": "ff1a3a5ea823bccdad0afd18675f2d47",
"sha256": "930c706cb027f687f0f71afcb3a52f05de0cc94887ab454eafcb21bc5c9789cc"
},
"downloads": -1,
"filename": "terminalcast-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "ff1a3a5ea823bccdad0afd18675f2d47",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 5677,
"upload_time": "2023-09-26T18:48:38",
"upload_time_iso_8601": "2023-09-26T18:48:38.670130Z",
"url": "https://files.pythonhosted.org/packages/78/8f/fec9bbf90771a0b90a2ac5fefb992519a364413014609041082cb0b07972/terminalcast-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-26 18:48:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vanadinit",
"github_project": "terminalcast",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "terminalcast"
}
JSON
