{"id":13514136,"url":"https://github.com/JaCzekanski/Avocado","last_synced_at":"2025-03-31T02:33:29.686Z","repository":{"id":34894784,"uuid":"38923428","full_name":"JaCzekanski/Avocado","owner":"JaCzekanski","description":"🥑 PlayStation 1 emulator","archived":false,"fork":false,"pushed_at":"2023-09-19T12:27:23.000Z","size":5977,"stargazers_count":545,"open_issues_count":57,"forks_count":30,"subscribers_count":29,"default_branch":"develop","last_synced_at":"2024-11-01T17:37:23.374Z","etag":null,"topics":["cpp","emulation","emulator","hacktoberfest","playstation","ps1","psx"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"facebook/create-react-app","license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JaCzekanski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"jaczekanski","ko_fi":"jaczekanski"}},"created_at":"2015-07-11T11:23:15.000Z","updated_at":"2024-10-22T13:21:42.000Z","dependencies_parsed_at":"2022-08-25T00:12:35.972Z","dependency_job_id":"9c898280-06e8-4f6e-867f-8ab9ad89c502","html_url":"https://github.com/JaCzekanski/Avocado","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaCzekanski%2FAvocado","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaCzekanski%2FAvocado/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaCzekanski%2FAvocado/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaCzekanski%2FAvocado/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JaCzekanski","download_url":"https://codeload.github.com/JaCzekanski/Avocado/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246407403,"owners_count":20772127,"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":["cpp","emulation","emulator","hacktoberfest","playstation","ps1","psx"],"created_at":"2024-08-01T05:00:47.394Z","updated_at":"2025-03-31T02:33:24.673Z","avatar_url":"https://github.com/JaCzekanski.png","language":"C++","funding_links":["https://github.com/sponsors/jaczekanski","https://ko-fi.com/jaczekanski"],"categories":["Sony","Home Game Console Emulators","Sony PlayStation 1"],"sub_categories":["PSX","Sony"],"readme":"# Avocado\nA Modern PlayStation 1 emulator.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\".github/screenshots/1.png\" height=\"250\"\u003e\n    \u003cimg src=\".github/screenshots/2.png\" height=\"250\"\u003e\n    \u003cimg src=\".github/screenshots/3.png\" height=\"250\"\u003e\n    \u003cimg src=\".github/screenshots/4.png\" height=\"250\"\u003e\n\u003c/p\u003e\n\nIf you have any questions just catch me on Twitter ([@JaCzekanski](https://twitter.com/JaCzekanski)) or create an [Issue](https://github.com/JaCzekanski/Avocado/issues). There is also [Discord server](https://discord.gg/ATEJApR).\n\n## Compatibility\n\nSee [Avocado compatibility list](https://avocado-db.czekanski.info)\n\n## Changelog\n\n*16.11.2021* - .vgs, .gme, .vmp memory card format support, load memory cards by drag\u0026drop\n\n*28.06.2020* - .ecm format support\n\n*16.09.2019* - Save states\n\n*5.09.2019* - Vibration support\n\n*2.09.2019* - Anti-Modchip and LibCrypt protected games support\n\n*13.03.2019* - merged MDEC (video decoder) support\n\n*8.12.2018* - created Compatibility list webapp\n\n*19.11.2018* - added .chd file support\n\n*9.11.2018* - XA-ADPCM (streaming audio) and Red Book audio support - music should play in most games, SPU samples interpolation (sounds less harsh), Pitch modulation support (used by few games), refactored CDROM reading and cue parsing subsystems, various fixes, hardware (OpenGL) rendering\n\n*27.08.2018* - Support for digital controller, DualShock (without vibrations) and mouse. Two controllers are supported (no multitap for now)\n\n*19.08.2018* - Memory card support\n\n*11.08.2018* - Partial SPU implementation - sound working\n\n## Status\n\nFull list: [Avocado Builds](https://avocado-builds.czekanski.info)\n\nBuild   | Status | Download\n--------|--------|---------\nLinux | [![Build Status](https://avocado-builds.czekanski.info/status/linux64)](https://github.com/JaCzekanski/Avocado/actions) | [develop](https://avocado-builds.czekanski.info/latest/linux64)\nmacOS | [![Build Status](https://avocado-builds.czekanski.info/status/macos)](https://github.com/JaCzekanski/Avocado/actions) | [develop](https://avocado-builds.czekanski.info/latest/macos)\nAndroid | [![Build Status](https://avocado-builds.czekanski.info/status/android)](https://github.com/JaCzekanski/Avocado/actions) | [develop](https://avocado-builds.czekanski.info/latest/android)\nWindows 64-bit, Visual Studio 2019 | [![Build status](https://avocado-builds.czekanski.info/status/windows64)](https://ci.appveyor.com/project/JaCzekanski/avocado/branch/develop) | **[develop](https://avocado-builds.czekanski.info/latest/windows64)**\nWindows 32-bit, Visual Studio 2019 | [![Build status](https://avocado-builds.czekanski.info/status/windows32)](https://ci.appveyor.com/project/JaCzekanski/avocado/branch/develop) | [develop](https://avocado-builds.czekanski.info/latest/windows32)\nWindows 64-bit, Visual Studio 2017 | [![Build status](https://ci.appveyor.com/api/projects/status/h1cs3bj1vhskjxgx/branch/develop?svg=true)](https://ci.appveyor.com/project/JaCzekanski/avocado/branch/develop) |\nWindows 32-bit, Visual Studio 2017 | [![Build status](https://ci.appveyor.com/api/projects/status/h1cs3bj1vhskjxgx/branch/develop?svg=true)](https://ci.appveyor.com/project/JaCzekanski/avocado/branch/develop) |\n\nDespite this emulator being in early development, some 3D games can run. [Game compatibility list](https://avocado-db.czekanski.info)\n\n\nCurrently audio is hard synced to NTSC (60Hz) (**running PAL games will make audio stutter**). The timer implementation does not function properly (**games fail to boot** or run at wrong speed). Many games won't boot or crash shortly after booting.\n\n## Requirements\n- OS: Windows 7 or later, macOS 10.13 or later, Linux (Ubuntu 16.04 or later)\n- GPU: Graphics card supporting **OpenGL 3.1**\n- CPU: [SSE3 compatible (CPUs after 2004)](https://en.wikipedia.org/wiki/SSE3#CPUs_with_SSE3) x64 or x86 processor\n\n### Notes\nAvocado focuses on supporting relatively modern hardware (2010 and forwards) and non-legacy OSes. \n\nEmulator is currently single-threaded - if you have multicore CPU you will not benefit from it. Single thread performance is what really matters.\n\nCurrently Avocado requires OpenGL 3.1. In the future this limitation will be lifted for software rendering.\n\n## Running\n\nAvocado requires the BIOS from real console in the `data/bios` directory. (use `File-\u003eOpen Avocado directory` to locate the directory on your system)\nSelection of a BIOS rom will be required on the first run. The rom can be changed under `Options-\u003eBIOS` or by modifying the **config.json** file.\n\nTo load a `.cue/.bin/.img/.chd/.ecm` or `.exe/.psexe/.psf/.minipsf` file just drag and drop it.\n\nPAL games with LibCrypt protection need additional subchannel info - download proper file `.SBI` or `.LSD` file from [Redump](http://redump.org/discs/system/psx/), place it in the same folder as game image and make sure has identical name as `.cue/.bin/...` file.\n\n## Controls\n\n- **Space** - pause/resume emulation\n- **F1** - hide GUI\n- **F2** - soft reset\n- **Shift-F2** - hard reset\n- **F5** - quick save\n- **F7** - quick load\n- **Tab** - disable framelimiting\n- **Backspace** - rewind one second\n\nConfigure controls under Options-\u003eController menu.\n\n## Build\n\n\n### Windows\nRequirements:\n- Visual Studio 2019 (2017 should work as well)\n- [Premake5](https://premake.github.io/download.html)\n\nFirst build: \n```\ngit clone --recursive https://github.com/JaCzekanski/Avocado.git\ncd Avocado\npremake5 vs2019\n\n# Open avocado.sln with Visual Studio, make sure that Release build is selected, build it\n```\n\nSee appveyor.yml in case of problems.\n\nUpdate:\n```\ngit pull \u0026\u0026 git submodule update --init --recursive\npremake5 vs2019\n\n# Open avocado.sln, build it\n```\n\n### Linux\nRequirements:\n- Clang6 or newer\n- [Premake5](https://premake.github.io/download.html)\n\nFirst build: \n```\nsudo apt update\nsudo apt install libsdl2-dev\ngit clone --recursive https://github.com/JaCzekanski/Avocado.git\ncd Avocado\npremake5 gmake\nmake config=release_x64 -j4\n\n# Running\n./build/release_x64/avocado\n```\n\nSee .ci/linux/build.sh in case of problems.\n\nUpdate:\n```\ngit pull \u0026\u0026 git submodule update --init --recursive\npremake5 gmake\nmake config=release_x64 -j4\n```\n\n### macOS\nRequirements:\n- XCode\n- [Premake5](https://premake.github.io/download.html)\n- [Brew](https://brew.sh)\n\nFirst build:\n```\nbrew update\nbrew install sdl2\ngit clone --recursive https://github.com/JaCzekanski/Avocado.git\ncd Avocado\npremake5 gmake\nmake config=release_x64 -j4\n\n# Running\n./build/release_x64/avocado.app\n```\n\nSee .ci/macos/build.sh in case of problems.\n\nUpdate:\n```\ngit pull \u0026\u0026 git submodule update --init --recursive\npremake5 gmake\nmake config=release_x64 -j4\n```\n\n## Bugs\n\nUse [GitHub issue tracker](https://github.com/JaCzekanski/Avocado/issues) to file bugs. Please attach [Game ID](http://redump.org/discs/system/psx/), screenshots/video, BIOS and build version.\n\nSee [Game compatibility list](https://avocado-db.czekanski.info) before creating a bug issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJaCzekanski%2FAvocado","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJaCzekanski%2FAvocado","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJaCzekanski%2FAvocado/lists"}