Skip to content

Latest commit

 

History

History
150 lines (105 loc) · 5.95 KB

README.md

File metadata and controls

150 lines (105 loc) · 5.95 KB
Raw

ItunesMediaPlayer

Description

Media Player built on top of VLC, VLCJ and various other open-source projects.

Features

1. Direct integration with Itunes Library.
2. Copy Itunes playlists/Tracks.
3. No VLC's UI or Itunes UI dependencies. Media player UI is built from ground up.
5. Play media from across the web including YouTube and Vimeo. This is enabled by the
   open-source project YouTube-DL (https://github.com/rg3/youtube-dl).
6. FileSystem Tree view to pin-point the library file being played on the computer.

Releases

Download the media player here: releases

Keyboard Shortcuts

Main Window

Shortcut MacOS Windows Linux
Open File CMD + O CTRL + O CTRL + O
Open Network CMD + N CTRL + N CTRL + N
Increase Volume SHIFT + UP SHIFT + UP SHIFT + UP
Decrease Volume SHIFT + DOWN SHIFT + DOWN SHIFT + DOWN
Seek Position CMD + G SHIFT + G SHIFT + G
Reload Itunes Library CMD + R CTRL + R CTRL + R
Copy Playlist CMD + P CTRL + P CTRL + P
Quit CMD + Q CTRL + Q CTRL + Q

Player Window

Shortcut MacOS Windows Linux
Toggle Fullscreen CMD + ENTER CTRL + ENTER CTRL + ENTER
Mute/Un-Mute CTRL + M CTRL + M CTRL + M
Increase Volume SHIFT + UP SHIFT + UP SHIFT + UP
Decrease Volume SHIFT + DOWN SHIFT + DOWN SHIFT + DOWN
Seek Forward SHIFT + RIGHT SHIFT + RIGHT SHIFT + RIGHT
Seek Backwards SHIFT + LEFT SHIFT + LEFT SHIFT + LEFT
Seek Forward(3sec) RIGHT RIGHT RIGHT
Seek Backwards(3sec) LEFT LEFT LEFT
Quit CMD + Q CTRL + Q CTRL + Q

Executable

1. While this can run on any machine with Java and VLC runtimes, this is primarily developed for Mac OSX and executables are compiled as Mac native app.
2. Linux executable can be run using the java command.            
3. Windows executable: TBA

Development

Tools:

*Note: Most developmental changes require simply running mvn clean install.
Replacing the ItunesMediaPlayer-jar-with-dependencies.jar file from player-ui/target under the pre-built ItunesMediaPlayer.app/Contents/Java folder will suffice.

However, in order to update youtube-dl or to create the Mac OS X native app programattically incorporating any changes, running mvn clean install -Denvironment=dev will do.

Java
    Maven (3.3.x is tested to work)
    Please see installing dependent library ItunesLibraryParser below.

YoutubeDL
YoutubeDL project downloads executable for Linux/Mac OSX and also for Windows.

Dependent libraries

ItunesLibraryParser
This is required to parse the Itunes Library XML file. The following script will clone, build and install the ItunesLibraryParser library in the local maven repository.

git clone https://github.com/leogps/ItunesLibraryParser.git

cd ItunesLibraryParser

mvn clean install

mvn install:install-file -Dfile="parser/target/com.gps.ilp-parser-2.0.1.jar" -DgroupId="com.gps" -DartifactId="ilp-parser" -Dversion="2.0.1" -Dpackaging="jar"

Apple JavaExtension

mvn install:install-file -Dfile="lib-runtime/ui.jar" -DgroupId="com.apple" -DartifactId="AppleJavaExtensions" -Dversion="1.6" -Dpackaging="jar"

VLC
Mac OSX: Latest VLC runtime for Mac OSX is already including in the commits.
For Linux, it is best to install the VLC which sets the LibVLC path automatically.
Debian Archiver -- .deb file build (Optional)

Builds dpkg file that can be used with Debian systems. dpkg needs to be available for this to work.

cd archiver
mvn clean install
cd debian
dpkg --build itunes-media-player
Build

After seeing that all non-optional requirements have been met, the project can be built using maven.

mvn clean install

Or build without running tests.

mvn clean install -DskipTests

Credits

VLC and its license can be found here:

http://www.videolan.org/legal.html

VLCJ library and its license can be found here:

https://github.com/caprica/vlcj

UI Designer, UI compilation, UI jar bundling powered by IntelliJ IDEA:

https://www.jetbrains.com/idea/

Known Limitations and Workarounds

Issue:
On Ubuntu, Splash screen interferes with vlcj initialization.
Workaround:
Start jvm with -DVLCJ_INITX=no
Issue:
On Mac OSX, Hardware Acceleration is available only in JDK 6.
Workaround:
Either use JDK 6 for better video performance or switch to JDK 6+ for Software Acceleration.
Issue:
VLC media player comes with plugin based on LUA to resolve web based video files, example YouTube videos and YouTube periodically changes the signatures to resolve the video file locations. YouTube-DL suffers from the same issue.
Workaround:
YouTube-DL project is pretty up-to-date in fixing the signatures and any issues, simply recompile the youtube-dl maven module and replace the resulting executable.
The installed version of the ItunesMediaPlayer can update Youtube-DL using Tools > Check for Updates. This will automatically update the underlying youtube-dl executable.