{"id":16649781,"url":"https://github.com/bronya-rand/renpy-universal-player","last_synced_at":"2025-04-09T17:05:36.753Z","repository":{"id":42185103,"uuid":"365838827","full_name":"Bronya-Rand/RenPy-Universal-Player","owner":"Bronya-Rand","description":"A music room/music player for all general Ren'Py projects.","archived":false,"fork":false,"pushed_at":"2022-04-11T19:15:34.000Z","size":11317,"stargazers_count":25,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T17:05:24.683Z","etag":null,"topics":["music","music-player","ost","renpy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bronya-Rand.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"ganstakingofsa","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-05-09T20:09:25.000Z","updated_at":"2025-01-26T21:18:25.000Z","dependencies_parsed_at":"2022-09-14T15:51:41.819Z","dependency_job_id":null,"html_url":"https://github.com/Bronya-Rand/RenPy-Universal-Player","commit_stats":null,"previous_names":["bronya-rand/renpy-universal-player"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bronya-Rand%2FRenPy-Universal-Player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bronya-Rand%2FRenPy-Universal-Player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bronya-Rand%2FRenPy-Universal-Player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bronya-Rand%2FRenPy-Universal-Player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bronya-Rand","download_url":"https://codeload.github.com/Bronya-Rand/RenPy-Universal-Player/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248074976,"owners_count":21043490,"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":["music","music-player","ost","renpy"],"created_at":"2024-10-12T09:12:23.305Z","updated_at":"2025-04-09T17:05:36.733Z","avatar_url":"https://github.com/Bronya-Rand.png","language":"Python","funding_links":["https://ko-fi.com/ganstakingofsa","https://ko-fi.com/K3K22K8SU"],"categories":[],"sub_categories":[],"readme":"# Ren'Py Universal Player (Ren'Py UOST-Player)\n[![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/K3K22K8SU)\n\n\u003cu\u003eCurrent Version:\u003c/u\u003e [**1.6**](https://github.com/GanstaKingofSA/RenPy-Universal-Player/releases/latest)\n\nRen'Py-Universal-Player or (Ren'Py UOST-Player) is a enhanced music room for Ren'Py projects that allows users to play tracks outside the game's story along with sideloaded songs. \n\n## Credits\n- Nikso - Original DDLC Music Player Developer\n- Sam Kujo#9403 - Original DDLC Music Player Design and Beta Tester\n- Staryxz#3613 - Original DDLC Music Player Beta Tester\n- Tom Rothamel - Feedback\n- RyzekNoavek#0624 - Adjustable Play Bar Code\n- khaase (Pixabay) - Refresh Icon (UOST-Player 1.0 - 1.2)\n- eugenialcala (Pixabay) - Replay Icon (UOST-Player 1.0 - 1.2)\n- raphaelsilva (Pixabay) - Shuffle Icon (UOST-Player 1.0 - 1.2)\n- Josy_Dom_Alexis (Pixabay) - Volume Icon (UOST-Player 1.0 - 1.2)\n- Google - Noto Sans SC Font (Author/Description Tag) and Icons (UOST-Player 1.3 onwards)\n- Ren'Py Discord - Feedback on Ren'Py Universal Player Features\n- Weiss Schnee - Support (Weiss :D)\n\n## Features\n1. MP3, OGG/OPUS, and WMA Playback from a folder or inside a RPA/APK file.\n2. Metadata support for tracks.\n3. Music player controls.\n4. Dynamic Font Scaling for Titles (some-what).\n5. Sorting support.\n6. Based off the Ren'Py auto-generated template screen.\n7. Music unlock support.\n8. RPA/APK Playback and Metadata Support\n   \u003e You will need to enable Developer Mode in order to make the metadata of songs in the track RPA folder generate for distribution.\n9. Android Support!\n\n## What do I need to run this?\n1. A Ren’Py project (new or existing).\n2. The recent version of [Ren'Py UOST-Player](https://github.com/GanstaKingofSA/RenPy-Universal-Player/releases).\n\n## How do I install this?\n\n1. Drop all the contents in this ZIP file to your projects' *game* folder.\n2.\tOpen \u003cu\u003escreens.rpy\u003c/u\u003e and add this line somewhere after line `291` under the *screen navigation():* block.\n   ```py\n   textbutton _(\"Music Room\") action [ShowMenu(\"music_room\"), Function(ost.get_music_channel_info), \n                                    Stop('music', fadeout=2.0), Function(ost.refresh_list)]\n   ```\n3. **(Optional)** Add some music to the \u003cu\u003etrack\u003c/u\u003e folder.\n4. Run your project and enter the Music Room!\n\n## What can I customize in Ren'Py UOST-Player?\nPretty much anything. This is based off the auto-generated Ren'Py template so everything is good for you to use as-is. Just change the settings under \u003cu\u003emusic_screen.rpy\u003c/u\u003e.\n\n## How do I manually define a song?\n\u003cu\u003emanualtracks.rpy\u003c/u\u003e has a small template to define songs manually if you need to do so. You have the following options to define these tracks.\n```\nname | Name of the track\npath | File path to the track from the game folder\npriority | Priortization of track on the list.\nauthor | Artist of the song\ndescription | Track description, comments, etc.\ncover_art | Path to the track's cover art (JPG/PNG Only)\nunlocked | Allows a song to be shown to the player or not.\n```\n\n## How do I priortize a song or make a song the first one?\nEnable the numbered list icon in the music room and set the song priority by a value. 0 is the highest priority you can make a song be while 1, 2, etc. will be prioritzed lower in the list. i.e. 0 \u003e 1 \u003e 2 \u003e ...\n\u003e You may also enable this by setting *organizePriority* to True within \u003cu\u003eost.py\u003c/u\u003e.\n\n## How do I make songs locked from the player?\nAs of now, the way to make a song unlock is by manually defining a song in \u003cu\u003emanualtracks.rpy\u003c/u\u003e. You can see a example on how this works in within the RPY file and under the **How do I manually define a song?** section of this Readme.\n\n## How do I add metadata info?\nRight-click your song, Select \u003cu\u003eProperties\u003c/u\u003e, go to \u003cu\u003eDetails\u003c/u\u003e, and fill the blank boxes you can.\nAlternatively, use [MusicBee](https://www.getmusicbee.com/) or a similar music player, or [MusicBrainz Picard](https://picard.musicbrainz.org/) and find your song.\n\n- For MusicBee: Right-Click your song within the player, select \u003cu\u003eEdit\u003c/u\u003e and edit away the info you want, then click \u003cu\u003eApply\u003c/u\u003e then \u003cu\u003eOK\u003c/u\u003e.\n- For MusicBrainz Picard: Add your song to Picard, select it, right-click the rectangle box that has 3 columns, select \u003cu\u003eAdd New Tag\u003c/u\u003e, select the tags you want to add like \u003cu\u003eTitle\u003c/u\u003e, \u003cu\u003eArtist\u003c/u\u003e, \u003cu\u003eComment\u003c/u\u003e, \u003cu\u003eAlbum\u003c/u\u003e, etc. There should be a blank box in the box area below, double-click it and edit away the info you want to add, then click \u003cu\u003eSave\u003c/u\u003e and press the \u003cu\u003eSave\u003c/u\u003e button near \u003cu\u003eInfo\u003c/u\u003e.\n\n## Why did you do this?\nI wanted to expand the original project I made with ([DDLC-OSTPlayer](https://github.com/GanstaKingofSA/DDLC-OSTPlayer)) to everyone else in Ren'Py. Originally made to see RWBY songs play within the Ren'Py engine. (Yang _:P_)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbronya-rand%2Frenpy-universal-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbronya-rand%2Frenpy-universal-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbronya-rand%2Frenpy-universal-player/lists"}