Skip to content
Vivek Kannan edited this page Jan 1, 2017 · 10 revisions

Welcome to the ChromeOsSubtitle Wiki!

This app was built to allow users to watch videos using the Google Chrome Browser along with a number of useful but missing features. The app aims to closely replicate the functionality of the VLC Media Player. However, bare in mind that this app is currently developed by only 2 people. So updates may show up a little late. Nevertheless, we will keep ours eyes and ears open and fix bugs and implement new features as quickly as possible.

The Media Controls Panel

The media controls panel allows the user to quickly access the most used actions using buttons. From left to right the elements and their functionality are as follows,

  1. Open Media Button - Used to open a new media from the filesystem. Media is opened and played immediately if the format is supported. Both audio files and video files are supported.
  2. Play/Pause Button - Used to Play/Pause the currently loaded media. Clicking the button when no media is loaded will result in File Open prompt.
  3. Stop Button - Used to stop the currently loaded media. Stopping results in pause followed by rewinding of the media to the beginning.
  4. Time Rail - Represents the progress of media graphically. Can be to used to seek to a particular position by clicking. A time float shows with the corresponding time to help seeking.
  5. Current/Total Time - Represents the time elapsed and the total duration. Clicking current time will toggle time remaining.
  6. Closed Caption Button - Used to select caption from filesystem, caption from list of downloaded captions, caption encoding, caption language, caption delay and size.
  7. Volume - Represents volume.
  8. Settings Panel - Can be used to change some of the settings. More to come.
  9. Info Panel - Provides information about the app.
  10. Help Button - Opens the help screen.
  11. FullScreen Button - Toggles fullscreen.

Shortcuts

Shortcuts are used to implement the less commonly used features. This is to ensure that the controls panel is not cluttered with buttons.

Shortcut Functionality
Ctrl + O Open Media
Spacebar Play/Pause
Shift/Alt/Ctrl + Right Seek Forward (3s/10s/60s)
Shift/Alt/Ctrl + Left Seek Backward (3s/10s/60s)
Ctrl + Up/Down Increase/Decrease Volume
Ctrl + A Cycle Aspect Ratio
Ctrl + F Toggle Fullscreen
Ctrl + X/Z Change Caption Delay
Ctrl + +/- Change Caption Size
Ctrl + Shift + Arrows Reposition Captions
Shift + Up/Down Change Brightness
Ctrl + Period/Comma Change Play Rate (Fine)
Ctrl + Shift + Period/Comma Change Play Rate (Coarse)
Ctrl + / Reset Playback Speed
Ctrl + D Download captions
Ctrl + L Toggle Loop
Ctrl + I Toggle Info Window
Ctrl + H Toggle Help Window
Ctrl + P Screen Grab (Screenshot)
Ctrl + ]/[ Next/Previous Media
Ctrl + Q Cycle Playlist Navigation
Alt + Period/Comma Change Audio Delay

Supported Formats

It must be understood that file format support is decided by the browser. We could write very complicated and resource hungry code to support Flash (FLV). It might be implemented at a later stage. Currently, formats supported include mp4, mp3, mkv, webm, m4v, ogg etc. Subtitle format support is limited to srt, ass, dfxp. This will change in the future.

Drag & Drop

Files along with their corresponding subtitle files can be dragged and dropped onto the player. The order of selection is important. To ensure that the subtitles are properly matched, select all the media files first and then the subtitles in the same order or select the files and the corresponding subtitle files together.

If A.mp4, B.ogg, C.mkv are the video files and A.srt, B.srt and C.srt are the subtitle files, then selection should be either
A.mp4, B.ogg and C.mkv and then A.srt, B.srt and C.srt (or)
A.mp4 and A.srt, B.ogg and B.srt, C.mkv and C.srt

Audio Delay

The Audio Delay is implemented with the help of WebAudio API. Unfortunately, negative delays are not supported by the API and thus are not supported by the player.

Soon to Come

  1. Flash Support
  2. Smartphone as Remote controller.
  3. chromeCast support (Fund us for a chromeCast :))

FAQS

1. Why isn't 'insert some file format' not working?
     Google Chrome Browser supports only a limited number of file formats and codecs. This app doesn't add any support for new formats (for now). The problem is difficult to solve. Try converting your file to a supported format (mp4/webm).

2. When I use 'insert language' captions, weird question marks appear instead of proper text.
     Try changing the encoding under the closed captions menu on the control panel. Usually, the correct encoding depends upon the language and the platform in which the subtitle was created. Try googling for the correct encoding for your language. The selection is remembered so you don't have to change it every time.

3. What about ChromeCast?
     Not supported for now. Might change in the future. Donate via Flattr to boost our morale so that we can work faster! :)

4. Where can I post feature requests or report bugs?
     Here on GitHub would be the most ideal place. Create an account if you don't have one and report bugs and make requests. Please go through the already existing requests/reports to avoid duplication. Also try you best to provide information while making bug reports. A simple 'doesn't work' is not going to help us at all. You could also use Chrome Web Store to make reports but GitHub is more preferable.