initial commit

Author: LabyStudio

.github/assets/banner.png

@@ -0,0 +1,31 @@
+name: Gradle build
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 16
+        uses: actions/setup-java@v1
+        with:
+          java-version: '16'
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+      - name: Build with Gradle
+        run: ./gradlew build
+      - name: Upload jar
+        uses: actions/upload-artifact@v2
+        with:
+          name: Artifacts
+          path: build/libs/*.jar

.github/workflows/gradle.yml

@@ -0,0 +1,9 @@
+.classpath
+.project
+.settings/*
+.idea
+/bin/
+out
+.gradle
+*.iml
+build

.gitignore

@@ -0,0 +1,78 @@
+![Banner](.github/assets/banner.png)
+
+<b>A Spotify API written in Java to access the current playing song.</b><br>
+There is no need for an access token, any internet connection or a premium account
+because the API reads the information directly from the application itself.
+
+#### Supported operating systems:
+- Windows
+
+## Gradle Setup
+```groovy
+repositories {
+    maven { url 'https://jitpack.io' }
+}
+
+dependencies {
+    implementation 'com.github.LabyStudio:java-spotify-api:1.0.0:all'
+}
+```
+
+## Example
+Create the API and get the current playing song and position:
+```java
+// Create a new SpotifyAPI for your operating system
+SpotifyAPI api = SpotifyAPIFactory.create();
+
+// It has no track until the song started playing once
+if (api.hasTrack()) {
+    System.out.println(api.getTrack());
+}
+
+// It has no position until the song is paused, the position changed or the song changed
+if (api.hasPosition()) {
+    System.out.println(api.getPosition());
+}
+```
+
+Register a listener to get notified when the song changes:
+```java
+api.registerListener(new SpotifyListener() {
+    @Override
+    public void onConnect() {
+        System.out.println("Connected to Spotify!");
+    }
+
+    @Override
+    public void onTrackChanged(Track track) {
+        System.out.println("Track changed: [" + track.getId() + "] " + track.getName() + " - " + track.getArtist() + " (" + formatDuration(track.getLength()) + ")");
+    }
+
+    @Override
+    public void onPositionChanged(int position) {
+        if (api.getTrack() == null) {
+            return;
+        }
+
+        int length = api.getTrack().getLength();
+        float percentage = 100.0F / length * position;
+
+        System.out.println("Seek: " + (int) percentage + "% (" + formatDuration(position) + " / " + formatDuration(length) + ")");
+    }
+
+    @Override
+    public void onPlayBackChanged(boolean isPlaying) {
+        System.out.println(isPlaying ? "Playing" : "Paused");
+    }
+
+    @Override
+    public void onSync() {
+
+    }
+
+    @Override
+    public void onDisconnect(Exception exception) {
+        System.out.println("Disconnected: " + exception.getMessage());
+    }
+});
+```

README.md

@@ -0,0 +1,25 @@
+plugins {
+    id 'java'
+    id 'com.github.johnrengelman.shadow' version '7.0.0'
+}
+
+group 'de.labystudio'
+version '1.0.0'
+
+compileJava {
+    sourceCompatibility = '1.8'
+    targetCompatibility = '1.8'
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation group: 'net.java.dev.jna', name: 'jna', version: '4.5.0'
+    implementation group: 'net.java.dev.jna', name: 'jna-platform', version: '4.5.0'
+}
+
+build {
+    dependsOn shadowJar
+}

build.gradle

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists