Giter Club home page Giter Club logo

chorus2's Introduction

Kodi Web Interface - Chorus2

The default Web Interface for Kodi.

A great modern Web UI for Kodi. Browse your Music, Movies or TV Shows from the comfort of your own web browser. You can play media via Kodi or stream it in your browser. Works best with Chrome but plays well with most modern browsers.

Successor to Chorus. A complete rebuild using Coffee Script, Backbone, Marionette and much, much more.

Author

Jeremy Graham with help from these kind people

Current state

Pretty good, most things work really well. Other things need polish/finishing/fixing.

Getting it working

Disclaimer: Beta software, expect bugs, changes, nuclear war, etc.

Installing

Install via zip is the easiest way to go. Grab the latest release of webinterface.default.2.X.X.zip from the releases page then install it like this

Configuring

  • Kodi > System > Settings > Services
  • Remote Control
    • Enable "Allow programs on this system to control Kodi"
    • Enable "Allow programs on other systems to control Kodi"
  • Webserver
    • Enable "Allow control of Kodi via HTTP"
    • Select Web interface
    • Select Chorus2

Feature requests / Bugs

Add them to the list

Streaming

Disclaimer: The success of this depends on the file formats vs what the browser supports. In general most things work.

Audio streaming

In the top right there are some tabs, two of them are named Kodi and Local, this is how you toggle what player the UI is controlling. In Local mode the logo and accents are pinky-red, In Kodi mode the logo is the Kodi blue. When you are in a given mode, actions affect that player, so if you click Play on a track when in Local mode, it will play through the browser, likewise, when in Kodi mode all commands are sent to Kodi. You can also add media to other playlists by clicking the menu buttons (three dots vertical) on most media items.

Video streaming

Video streaming via HTML5 "sort of" works, it really depends on the codec used. An embedded VLC player is also available with better codec support. This looks like the best we can get until Kodi supports transcoding. Chrome users: Chrome has removed support for vlc/divx plugins so streaming a video requires a Chrome friendly codec.

Kodi settings via the web interface

You can change most of the settings you would find in Kodi via the settings page in the web interface. Some settings have been omitted as they require interaction with the GUI and others are just a basic text field with no options.

Contributing

If you would like to make this project better I would appreciate any help. Please do pull requests against the develop branch.

Translations

I only know English so definitely need help with this.
I also don't know heaps about javascript multilingual stuff but thanks to @mizaki we have a structure ready to go. So it should be nice and easy to translate the UI.

At the moment, there is 5 languages (english,french,german,dutch,chinese) more can be easily added. To contribute, send me a PR on a new branch against develop, or if you don't know git, a link to the language file.

Language Files here. English is the only real complete translation file so start with that as your base.

Compiling

Sass and Grunt are used to compile css and js in the dist folder. To get your environment setup first install Bundler and npm.

  • Install required gems with bundle install
  • Install NodeJs packages with npm install
  • Run grunt grunt

If you are updating (eg. git pull), always do an npm update and bundle update to ensure all the tools are in the toolbox.

Build

A build will also include translation files.

  • Run grunt grunt build

Donate

Are you a fan of Chorus? You can buy Jeremy a beer to say thanks :)

Screenshots

Homepage (now playing)

alt text

Search results

alt text

Artists

alt text

alt text

Video library

alt text

Filtering

alt text

Settings

alt text

Add-ons

alt text

chorus2's People

Contributors

bertenvdb avatar dadittoz avatar driet avatar jairbubbles avatar jez500 avatar misterj3012 avatar mizaki avatar rubo77 avatar sirloinofbeef avatar tim-yao avatar tintamarre avatar un1versal avatar zapata11 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.