{"id":16549606,"url":"https://github.com/hteumeuleu/playorama","last_synced_at":"2025-03-16T19:32:58.636Z","repository":{"id":38690168,"uuid":"473357381","full_name":"hteumeuleu/playorama","owner":"hteumeuleu","description":"A cranky video player for the Playdate","archived":false,"fork":false,"pushed_at":"2024-08-05T11:22:06.000Z","size":3370,"stargazers_count":45,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-12T19:30:02.453Z","etag":null,"topics":["playdate","playdate-console"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/hteumeuleu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"Support/NOTES.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-23T21:01:58.000Z","updated_at":"2024-09-28T13:15:50.000Z","dependencies_parsed_at":"2023-02-10T10:15:34.546Z","dependency_job_id":"b9ff4b92-f715-4e3e-aa92-80a3c4fc4c89","html_url":"https://github.com/hteumeuleu/playorama","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hteumeuleu%2Fplayorama","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hteumeuleu%2Fplayorama/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hteumeuleu%2Fplayorama/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hteumeuleu%2Fplayorama/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hteumeuleu","download_url":"https://codeload.github.com/hteumeuleu/playorama/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221667534,"owners_count":16860621,"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":["playdate","playdate-console"],"created_at":"2024-10-11T19:29:59.980Z","updated_at":"2024-10-27T11:11:13.648Z","avatar_url":"https://github.com/hteumeuleu.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Playorama](/Source/SystemAssets/card.png)\n\n# A cranky video player for the Playdate\n\nPlayorama is a _cranky_ video player for the Playdate. You can use the crank to fast forward and backward or move frame by frame through a video.\n\n## 1. How to use\n\n*Warning*: The process to get your own videos on the Playdate is a bit clunky. There’s a demo video included in the application if you’re not at ease with encoding video and audio.\n\n### 1.1. Download and install\n\n1. Download the latest release at https://github.com/hteumeuleu/playorama/releases .\n2. Get the `Playorama.pdx` file.\n3. Sideload it to your Playdate device. (You can refer to the official [Sideloading Playdate games](https://help.play.date/games/sideloading/) documentation.)\n\n### 1.2. Controls\n\nWhile a video is playing, you can use the following controls.\n\n* `A`: pause\n* `B`: menu\n* `Up`: toggle track bar\n* `Left` and `Right`: toggle through different playback speed\n* `Crank`: change playback speed up to 4x \n\nIf the video is paused, using `Left` and `Right` or the `Crank` will move frame by frame.\n\n### 1.3. Options\n\nPlayorama has two options available in the Playdate System Menu:\n\n* VCR effect: adds a VCR pause effect to the video when going fast forward, backward or frame by frame.\n* Log: show errors that occured while opening your own video and audio files. \n\n## 2. Add videos\n\n1. Connect your Playdate to your computer in [Data Disk mode](https://help.play.date/games/sideloading/#data-disk-mode).\n2. In the main `Data` folder, locate or create the folder the app has access to. The folder shall be named either:\n\t* `com.hteumeuleu.playorama` if you sideloaded the app over a USB connection, \n\t* `user.xxxx.playorama` if you sideloaded the app through the Playdate website **before february 2023** (where `xxxx` should be replaced by your user number used in other folder names),\n\t* `user.xxxx.com.hteumeuleu.playorama` if you sideloaded the app through the Playdate website **after february 2023** and Playdate OS update 1.12.\n3. Add your video and audio files inside. Both files should have the same base name (for example: `sample.pdv` and `sample.pda`).\n\n### 2.1. Sample videos\n\nYou can download the following videos to try it out.\n\n_(Coming soon!)_\n\nDownload an archive and extract it in the application data folder (See `2.` above.).\n\n### 2.2. Encode your own videos\n\n#### Using the online Playdate Video Encoder\n\n1. Go to [pdv.hteumeuleu.com](https://pdv.hteumeuleu.com/).\n2. Use the web app to encode your video. You will only get a `.pdv` file for the video.\n3. Use another software like _ffmpeg_ to export the audio as an `.mp3`.\n\n#### Using 1bitvideo on macOS\n\n1. Download `1bitvideo.app` the video encoder made by Panic’s Dave Hayden: [https://devforum.play.date/t/video-encoder-work-in-progress-mac-only/1390/23](https://devforum.play.date/t/video-encoder-work-in-progress-mac-only/1390/23). \n2. Use the app to encode your video. When done, you will get both a `.pdv` and a `.m4a` file. The Playdate can not read an `.m4a` from a data folder, so we need to encode the audio into `.pda`.\n3. Encode the audio into MP3. The Playdate SDK documentation provides indication into how to do this using either _Audacity_ or _ffmpeg_: [https://sdk.play.date/1.11.1/Inside%20Playdate.html#f-sound.getSampleRate](https://sdk.play.date/1.11.1/Inside%20Playdate.html#f-sound.getSampleRate).\n\n#### Using ffmpeg and a custom script\n\n[Crank Player](https://github.com/saagarjha/CrankPlayer) has a bash script that relies on ffmpeg and a custom Python script to convert a video into a `.pdv`.\n\n## 3. Source Code\n\nYou can compile the code with the following command:\n\n```sh\npdc ./Source/ Playorama.pdx\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhteumeuleu%2Fplayorama","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhteumeuleu%2Fplayorama","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhteumeuleu%2Fplayorama/lists"}