Better-Youtube-Plus/README.md

# Better Youtube +
Better YouTube + works to improve the YouTube experience by providing quick access to features we'd all like to have from the get-go.
<br/>
  * It defaults playback to 1080p if able to.
  * It allows quick thumbnail access of the video.
  * It allows setting the loop mode easily.
  * It allows setting the loop mode to a ranged set.
  * It allows the video to be toggled to fixed or floating. (With drag functionality!)
  * It allows volume control through the mouse-wheel when hovering over the player.
  * It allows for quick access to the YouTube video slug.
  * It allows for NonStop watch mode. (i.e, no "Are you still there?" dialog.)
  * It shows volume level as you scroll.
  * It lets Unix, Linux, and MacOS systems have the ability to download the video using native app calls.

# Version: 1.5.6
* 1080p playback defaulting... fix ...?

# Download
https://addons.mozilla.org/en-US/firefox/addon/better-youtube-plus/

# Images
![1 Controls... ](images/pic1.png)
![2 Thumbnail list... ](images/pic2.png)
![3 Secondary controls... ](images/pic3.png)
![4 Video in float mode... ](images/pic4.png)
![5 Video moved around in float mode... ](images/pic5.png)

# NOTE
On *Nix systems download youtube-dl and use provided app in this repo to download videos.

##### Mac OS/Linux Setup
To get downloading working do the following:

1. Check that the [file permissions](https://en.wikipedia.org/wiki/File_system_permissions) for "youtube-dl-bridge.py" include the `execute` permission.
2. Edit the "path" property of "web_video_dl.json" to point to the location of "youtube-dl-bridge.py" on your computer.
3. copy "web_video_dl.json" to the correct location on your computer. See [App manifest location ](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Native_manifests#Manifest_location) to find the correct location for your OS.
4. Install the webextension and enjoy!
Initial code publish. 2017-12-23 01:44:41 +00:00			`# Better Youtube +`
Fixed video player in full-screen being behind controls. 2018-11-17 21:25:57 +00:00			`Better YouTube + works to improve the YouTube experience by providing quick access to features we'd all like to have from the get-go.`
Initial code publish. 2017-12-23 01:49:29 +00:00			`<br/>`
defaulting player to 1080p if possible 2021-02-28 05:19:27 +00:00			`* It defaults playback to 1080p if able to.`
Initial code publish. 2017-12-23 01:49:29 +00:00			`* It allows quick thumbnail access of the video.`
			`* It allows setting the loop mode easily.`
Fixed floating container, added ranged loop, removed old code. 2018-12-28 07:47:28 +00:00			`* It allows setting the loop mode to a ranged set.`
refactored, added volume indicator on scroll, added endless play mode 2020-05-16 01:36:21 +00:00			`* It allows the video to be toggled to fixed or floating. (With drag functionality!)`
Initial code publish. 2017-12-23 01:49:29 +00:00			`* It allows volume control through the mouse-wheel when hovering over the player.`
Update README.md 2018-08-04 17:05:16 +00:00			`* It allows for quick access to the YouTube video slug.`
refactored, added volume indicator on scroll, added endless play mode 2020-05-16 01:36:21 +00:00			`* It allows for NonStop watch mode. (i.e, no "Are you still there?" dialog.)`
			`* It shows volume level as you scroll.`
			`* It lets Unix, Linux, and MacOS systems have the ability to download the video using native app calls.`
Added download feature for Unix, Linux, and MacOS systems using native messaging. 2019-01-07 07:48:10 +00:00
Playback resolution fix? 2021-02-28 06:32:27 +00:00			`# Version: 1.5.6`
			`* 1080p playback defaulting... fix ...?`
Initial code publish. 2017-12-23 01:44:41 +00:00
This version is a big overhaul and change in logic plus cleansup code styling. 2018-05-07 08:23:22 +00:00			`# Download`
			`https://addons.mozilla.org/en-US/firefox/addon/better-youtube-plus/`

refactored, added volume indicator on scroll, added endless play mode 2020-05-16 01:36:21 +00:00			`# Images`
			`![1 Controls... ](images/pic1.png)`
			`![2 Thumbnail list... ](images/pic2.png)`
			`![3 Secondary controls... ](images/pic3.png)`
			`![4 Video in float mode... ](images/pic4.png)`
			`![5 Video moved around in float mode... ](images/pic5.png)`

Added download feature for Unix, Linux, and MacOS systems using native messaging. 2019-01-07 07:48:10 +00:00			`# NOTE`
			`On *Nix systems download youtube-dl and use provided app in this repo to download videos.`

			`##### Mac OS/Linux Setup`
			`To get downloading working do the following:`

			1. Check that the [file permissions](https://en.wikipedia.org/wiki/File_system_permissions) for "youtube-dl-bridge.py" include the `execute` permission.
			`2. Edit the "path" property of "web_video_dl.json" to point to the location of "youtube-dl-bridge.py" on your computer.`
			`3. copy "web_video_dl.json" to the correct location on your computer. See [App manifest location ](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Native_manifests#Manifest_location) to find the correct location for your OS.`
			`4. Install the webextension and enjoy!`