{"id":18240074,"url":"https://github.com/brys0/spotify-web","last_synced_at":"2025-04-04T08:30:46.013Z","repository":{"id":53556110,"uuid":"327725699","full_name":"brys0/Spotify-Web","owner":"brys0","description":"A simple and easy to use online webserver for parsing spotify tracks playlists albums artists and more!","archived":false,"fork":false,"pushed_at":"2021-10-15T14:39:31.000Z","size":90909,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-20T06:42:56.097Z","etag":null,"topics":["spotify-api","spotify-playlist","spotify-web","spotify-web-api","webserver"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brys0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-07T21:10:51.000Z","updated_at":"2024-11-11T17:28:31.000Z","dependencies_parsed_at":"2022-09-10T18:16:57.519Z","dependency_job_id":null,"html_url":"https://github.com/brys0/Spotify-Web","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brys0%2FSpotify-Web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brys0%2FSpotify-Web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brys0%2FSpotify-Web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brys0%2FSpotify-Web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brys0","download_url":"https://codeload.github.com/brys0/Spotify-Web/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247146831,"owners_count":20891574,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["spotify-api","spotify-playlist","spotify-web","spotify-web-api","webserver"],"created_at":"2024-11-05T04:05:01.153Z","updated_at":"2025-04-04T08:30:41.000Z","avatar_url":"https://github.com/brys0.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spotify-Web\n![img](https://raw.githubusercontent.com/brys0/Spotify-Web/v.10.21/Art/sws-v.1.0.21.png)\nA simple and easy to use online webserver for parsing spotify tracks playlists albums artists and more!\n\n# Welcome to Spotify Web\n### Lets get started!\n\n\u003e Woah what port is this hosted on?\n\nThe server will be hosted on port `8080` (You can change this! ⬇️ look below ⬇️) on the machine if your also connecting to it on the same machine just put in your browser (or code) `localhost:8080`\n\n```kotlin\n┌───────────────────────────────────────────────Endpoints───────────────────────────────────────────────┐\n /                   │ The default home page\n /track              │ Returns a track json object. Requires a valid track id (/track?id=yourid)\n /playlist           │ Returns a playlist json object. Requires a valid playlist id (/playlist?id=yourid)\n /album              │ Returns a album json object. Requires a valid album id (/album?id=yourid)\n /artist             │ Returns a artist json object. Requires a valid artist id (artist/?id=yourid)\n /new                │ Returns all converted tracks and new hits on spotify\n /categories         │ Get all categories and their names / images\n /user               │ Returns a user json object. Requires a valid username (/user?name=YourUsername)\n /system/cpu         │ Returns cpu thread stats\n /system/mem         │ Returns memory stats\n /system/gc          │ Calls the jvm to attempting to garbage collect\n /system/cache       │ Returns cache stats\n /system/cache/clear │ Clears all cache\n└──────────────────────────────────────────────────────────────────────────────────────────────────────┘\n```\n\n\n\u003e Can I change the database?\n\nRight now currently on this release it only holds data in a HashMap\u003c\u003e or \"Cache\" effectively, However in the future it should be able to use MongoDB and Redis once we get the bugs figured out!\n\n\u003e Can I change the port of the webserver?\n\nYes you can! just add `-Dserver.port=YourPort` to your startup looking something like this `java -Dserver.port=9090 -jar ./SpotifyWeb-1.0.0.jar` Will run the default web server on port **9090**\n\n\u003e I need a version for `\u003cInsert_Programming_Lang_Here\u003e` when will that be coming out?\n\nNever, unless someone decides to make a version for other programming languages.\n### Community Clients\n\n[**NodeJS/TS** `SWWrap`](https://github.com/WubzyGD/SWWrap) - [**WubzyGD**](https://github.com/WubzyGD)\n\u003e Will there ever be a lighter version of this webserver available?\n\nYes! There should be a version coming out that just uses the raw JRE support, and should shrink the memory usage/jar size by up to 50%\n\n\u003e How can I contribute?\n\n1. Fork this repo\n2. Update whatever you were planning\n3. Submit a PR with the tag **UPDATE**\n4. Wait.\n\nMake sure to read the contributing guidelines too! [`Click Here`](https://github.com/brys0/Spotify-Web/blob/master/CONTRIBUTING.md)\n\u003e What does each request look like?\n\n**Track**\n```json\n{\n\t\"name\": String,\n\t\"artwork\": String,\n\t\"artist\": String,\n\t\"popularity\": Int,\n\t\"explicit\": Boolean,\n\t\"duration\": Long,\n\t\"track_num\": Int,\n\t\"converted_trk\": String\n}\n```\n\n**Playlist**\n```json\n{\n\t\"name\": String,\n\t\"owner\": String,\n\t\"description\": String,\n\t\"followers\": Int,\n\t\"image\": String,\n\t\"snapshot\": String,\n\t\"tracks\": Array\n}\n```\n**Album**\n```json\n{\n\t\"name\": String,\n\t\"artists\": String,\n\t\"release_date\": String,\n\t\"popularity\": Int,\n\t\"image\": String,\n\t\"label\": String,\n\t\"total_tracks\": Int,\n\t\"tracks\": Array\n}\n```\n**Artist**\n```json\n{\n\t\"name\": String,\n\t\"followers\": Int,\n\t\"genres\": Array,\n\t\"image\": String,\n\t\"top_tracks\": Array\n}\n```\n\n**New**\n```json\n{\n\t\"Track_Rec\": Array\n}\n```\n\n**User**\n```json\n{\n\t\"name\": String,\n\t\"followers\": Int,\n\t\"image\": String\n}\n```\n**Categories**\n```json\n{\n\t\"names\": Array,\n\t\"images\": Array,\n}\n```\n**System/CPU**\n```json\n{\n\t\"alive\": Int,\n\t\"parked\": Int\n}\n```\n**System/MEM**\n```json\n{\n\t\"total\": String,\n\t\"max\": String,\n\t\"available\": String,\n\t\"used\": String\n}\n```\n**System/GC**\n```json\n{\n\t\"gc\": Boolean\n}\n```\n**System/CACHE**\n```json\n{\n\t\"tracks\": Int,\n\t\"playlists\": Int,\n\t\"albums\": Int\n}\n```\n**System/CACHE/CLEAR**\n```json\n{\n\t\"cache\": Boolean\n}\n```\n\nThats alot of response json 👀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrys0%2Fspotify-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrys0%2Fspotify-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrys0%2Fspotify-web/lists"}