/youtube-playlist-player

Watch and edit YouTube playlists on the desktop.

Primary LanguageCSSMIT LicenseMIT

YouTube Playlist Player Beta travis appveyor npm dependencies devDependencies



Watch & edit your YouTube playlist on the desktop.
Available for macOS, Windows and Linux.

Features

Multiple Viewing Modes

Supports regular Playback as well as YouTube TV (Leanback) viewing modes.

Unobstrusive

Watch videos without browser chrome.

Efficient

Enables hardware-accelerated h264 YouTube playback across platforms.

Simple

Copy & paste a YouTube playlist URL to get started. Login to edit playlists.

Adblocker

Filters on-page and in-stream ads.

Contents

  1. Installation
  2. Developers
  3. Continuous Integration
  4. Contact
  5. Author

Installation

Standard Installation

Download the latest version of YouTube Playlist Player on the Releases page.

Installation as Commandline Tool

npm install --global youtube-playlist-player		# Installs the node CLI module
youtube-playlist-player							# Runs it

Developers

Sources

Clone the repo and install dependencies.

git clone https://github.com/sidneys/youtube-playlist-player.git youtube-playlist-player
cd youtube-playlist-player
npm install

Scripts

npm run start

Run the app with integrated Electron.

npm run start
npm run start:dev 					# with Debugging Tools
npm run start:livereload 			# with Debugging Tools and Livereload

npm run localsetup

Install the app in the System app folder and start it.

npm run localsetup
npm run localsetup:rebuild			# Build before installation
npm run localsetup:rebuild:dev 		# Build before installation, use Developer Tools

npm run build

Build the app and create installers (see requirements).

npm run build					# build all available platforms
npm run build macos windows		# build specific platforms (macos/linux/windows)

Build Requirements

  • Building for Windows requires wine and mono (on macOS, Linux)
  • Building for Linux requires fakeroot and dpkg (on macOS, Windows)
  • Only macOS can build for other platforms.

macOS Build Setup

Install Homebrew, then run:

brew install wine mono fakeroot dpkg

Linux Build Setup

sudo apt-get install wine mono fakeroot dpkg

Continuous Integration

Turnkey build-in-the-cloud for Windows 10, macOS and Linux.

The process is managed by a custom layer of node scripts and Electron-optimized configuration templates. Completed Installation packages are deployed to GitHub Releases. Builds for all platforms and architectures take about 5 minutes. Backed by the open-source-friendly guys at Travis and AppVeyor](https://ci.appveyor.com/) and running electron-packager under the hood.

Setup

  1. Fork the repo
  2. Generate your GitHub Personal Access Token using "repo" as scope. Copy it to the clipboard.
  3. macOS + Linux
    1. Sign in to Travis using GitHub.
    2. Open your Travis Profile, click "Sync Account" and wait for the process to complete.
    3. Find this repository in the list, enable it and click "⚙" to open its settings.
    4. Create a new Environment Variable named GITHUB_TOKEN. Paste your Token from step 2 as value.
  4. Windows
    1. Sign in to AppVeyor using GitHub.
    2. Click on "New Project", select "GitHub", look up this repo in the list and click "Add".
    3. After import navigate to the Settings > Environment subsection
    4. Select "Add Variable", insert GITHUB_TOKEN for name, paste your Token as value. Save.

Triggering Builds

  1. Add a new Tag to start the build process:

    git tag -a v1.0.1
git push --tags

    The builds are started in parallel and added to the "Releases" page of the GitHub repo (in draft mode).

  2. Use the editing feature to publish the new app version.

  3. There is no step 3

Contact Contributions Wanted

  • Gitter Developer Chat
  • Issues File, track and discuss features and issues
  • Wiki Read or contribute to the project Wiki

Author

sidneys 2016