https://github.com/davibe/castoro

A tool to stream local files to chromecast. Device discovery, volume control, seeking support, automatic subtitles loading based on media filename, audio transcoding.
https://github.com/davibe/castoro

Last synced: 2 months ago
JSON representation

A tool to stream local files to chromecast. Device discovery, volume control, seeking support, automatic subtitles loading based on media filename, audio transcoding.

• Host: GitHub
• URL: https://github.com/davibe/castoro
• Owner: davibe
• Created: 2015-04-21T11:03:05.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2017-07-20T05:49:02.000Z (over 7 years ago)
• Last Synced: 2024-10-31T04:50:38.951Z (3 months ago)
• Language: CoffeeScript
• Homepage:
• Size: 7.36 MB
• Stars: 7
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[This project is not maintained anymore]

Description

-----------

A tool to cast your local files to chromecast. Device discovery, volume

control, seeking support, automatic subtitles loading based on media filename,

audio transcoding. Experimental user interface is being worked on.

Desktop application

-------------------

First binary distribution is now

[available for OSX](https://github.com/davibe/castoro/releases/)

Commandline tool

----------------

### Install

You can user npm published version

    

    npm install -g castoro

or roll one yourself from this repo

    npm install -g coffee-script

    cd [this repo]

    npm run-script prepublish

    npm install -g

### Usage

Command line usage goes like this

      castoro \

        --mode [original|stream-transcode|transcode] \

        --input [path/to/file.mkv]

Optional arguments

        --ip [ip of your machine]

        --port [http port to use]

        --cli-controller # enables cli controller

#### Mode(s) explained

- **original**: The tool will stream un-modified input file using HTTP. Since chromecast is

picky about formats (expecially audio ones) the file must be properly encoded.

- **stream-transcode** (default): The tool will live transcode the input file to fit chromecast audio capabilities

using ffmpeg. Seeking is supported in this case, but slower.

- **transcode**: The tool will

    1. start to cast the input media to the chromecast using stream-transcode mode

       (slower seeking)

    2. start a transcoding process converts the entire input media

    3. as soon as the transcoding (2) is finished it will switch playback to the

       trascoded file (faster seeking)

### Cli controller

If you enable the cli controller you can use keys to control playback/volume

right from the console

- Up: Volume up

- Down: Volume down

- Left: RR (10 min)

- Shift+Left: RR (1 min)

- Right: FF (10 min)

- Shift+Right: FF (1 min)

- Space: Pause/Unpause

- key "s": Print player status

- key "q": Quit

### UI Controller (Experimental)

Experimental UI allows drag-dropping video files and control playback as a

desktop application. See screenshots

![](images/ui01.PNG)

Current status of UI support is

- still very experimental

- using [electron.atom.io](http://electron.atom.io)

- tested on Mac OSX

To test it you can clone this repo and then use

    npm run-script prepublish; electron .

FFMPEG dependency

-----------------

This tool uses FFMpeg. FFMpeg must be installed on the system. I run it on OSX

where I installed ffmpeg using Homebrew like this

    brew install ffmpeg --with-faac --with-fdk-aac

Bundled distributions of the application also include ffmpeg binaries.

Todos

-----

Pull requests are welcome

- Transcode video when needed (currently we just transcode audio)

- Properly report errors

- Automatically pick an available port

- Support multiple chromecasts in the same network

- Distrubuted bundled application with UI and possibly ffmpeg binaries

![](images/castoro.png)