{"id":25048075,"url":"https://github.com/dev-0x7c6/meta-retro","last_synced_at":"2026-03-16T23:32:13.216Z","repository":{"id":40464503,"uuid":"230910558","full_name":"dev-0x7C6/meta-retro","owner":"dev-0x7C6","description":"OpenEmbedded / Yocto software layer for RetroArch and libretro cores","archived":false,"fork":false,"pushed_at":"2024-11-13T14:17:06.000Z","size":1324,"stargazers_count":26,"open_issues_count":3,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-14T04:57:37.458Z","etag":null,"topics":["distro","embedded","kodi","libretro","libretro-cores","meta-intel","meta-libretro","meta-raspberrypi","meta-retro","openembedded","openembedded-layer","raspberrypi","retro","retro-gaming","retro-image","retroarch","retrogaming","yocto","yocto-layer"],"latest_commit_sha":null,"homepage":"","language":"BitBake","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/dev-0x7C6.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":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-12-30T12:18:08.000Z","updated_at":"2025-01-01T04:59:11.000Z","dependencies_parsed_at":"2024-10-20T04:29:56.318Z","dependency_job_id":"16a10681-6b23-4458-b2bb-e3fded6676c4","html_url":"https://github.com/dev-0x7C6/meta-retro","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dev-0x7C6/meta-retro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-0x7C6%2Fmeta-retro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-0x7C6%2Fmeta-retro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-0x7C6%2Fmeta-retro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-0x7C6%2Fmeta-retro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dev-0x7C6","download_url":"https://codeload.github.com/dev-0x7C6/meta-retro/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-0x7C6%2Fmeta-retro/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269832882,"owners_count":24482330,"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","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["distro","embedded","kodi","libretro","libretro-cores","meta-intel","meta-libretro","meta-raspberrypi","meta-retro","openembedded","openembedded-layer","raspberrypi","retro","retro-gaming","retro-image","retroarch","retrogaming","yocto","yocto-layer"],"created_at":"2025-02-06T07:46:09.038Z","updated_at":"2026-03-16T23:32:13.143Z","avatar_url":"https://github.com/dev-0x7C6.png","language":"BitBake","funding_links":[],"categories":[],"sub_categories":[],"readme":"## OpenEmbedded / Yocto software layer for RetroArch and libretro cores\n\nThis layer provides RetroArch front-end and libretro cores emulators\nrecipes for use with OpenEmbedded and/or Yocto.\n\n![Raspberry Pi 4 Poky build](https://devwork.space/wp-content/uploads/2020/01/IMG_20200108_205652-scaled.jpg)\n\n## Building\n\nYou can test this layer and distro (retro) with reference build environment on your host computer\n\n```console\nuser@localhost:~$ git clone --recursive https://github.com/dev-0x7C6/retro-build-environment.git\nuser@localhost:~$ cd retro-build-environment\nuser@localhost:~$ source source.me\nuser@localhost:~$ MACHINE=\"raspberrypi4\" bitbake retro-image-full\n```\n\n## Images\n\n| Image (recipe name)                                                 | Retroarch          | Libretro cores     | Shaders            | Titles             | Cheats             | Themes             | Overlays             |\n|:--------------------------------------------------------------------|:------------------:|:------------------:|:------------------:|:------------------:|:------------------:|:------------------:|:--------------------:|\n| [retro-image-full](recipes-core/images/retro-image-full.bb)         | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:   |\n| [retro-image-standard](recipes-core/images/retro-image-standard.bb) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |                    |                    |                      |\n| [retro-image-minimal](recipes-core/images/retro-image-minimal.bb)   | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |                    |                    |                    |                      |\n\nRecomendation: [retro-image-full](recipes-core/images/retro-image-full.bb)\n\n## Tested platforms\n\n| Machine           | Layer                                                                            | Build against | Runtime testing | Notice                                                                     |\n|:------------------|:--------------------------------------------------------------------------------:|:-------------:|:---------------:|:---------------------------------------------------------------------------| \n| `cubietruck`      | [meta-sunxi](https://github.com/linux-sunxi/meta-sunxi)                          |  Often        | Rarely          | Unable to run kms with lima(mesa)                                          |\n| `intel-core2-32`  | [meta-intel](https://git.yoctoproject.org/cgit/cgit.cgi/meta-intel/)             |  Often        | Sometimes       | As pendrive dongle                                                         |\n| `intel-corei7-64` | [meta-intel](https://git.yoctoproject.org/cgit/cgit.cgi/meta-intel/)             |  Often        | Sometimes       | As pendrive dongle                                                         |\n| `orange-pi-pc`    | [meta-sunxi](https://github.com/linux-sunxi/meta-sunxi)                          |  Often        | Rarely          | ---                                                                        |\n| `raspberrypi3-64` | [meta-raspberrypi](https://git.yoctoproject.org/cgit/cgit.cgi/meta-raspberrypi/) |  Often        | Sometimes       | ---                                                                        |\n| `raspberrypi3`    | [meta-raspberrypi](https://git.yoctoproject.org/cgit/cgit.cgi/meta-raspberrypi/) |  Often        | Sometimes       | ---                                                                        |\n| `raspberrypi4-64` | [meta-raspberrypi](https://git.yoctoproject.org/cgit/cgit.cgi/meta-raspberrypi/) |  Always       | Often           | ---                                                                        |\n| `raspberrypi4`    | [meta-raspberrypi](https://git.yoctoproject.org/cgit/cgit.cgi/meta-raspberrypi/) |  Always       | Often           | ---                                                                        |\n| `rock-pi-4a`      | [meta-rockchip](https://git.yoctoproject.org/cgit/cgit.cgi/meta-rockchip/)       |  Often        | None            | Thanks to [@MarkusVolk](https://github.com/MarkusVolk) for sending patches |\n\n## Distro features\n\nMeta-retro introduced a collection of switches that can be set by **DISTRO_FEATURES** in *local.conf* or *distro.conf*\n\n#### RetroArch and system features:\n\n* **retroarch-automount** - added extra automounting in /var/run/media\n* **retroarch-autostart** - enabling systemd RetroArch startup as main graphics.target\n* **retroarch-online** - compile RetroArch with online capabilities\n* **retroarch-updater** - compile RetroArch with update capabilities\n\n#### Graphical capabilities:\n* **retroarch-gles** - enable for OpenGLES 2.0 support in retroarch and libretro cores\n* **retroarch-gles3** - enable for OpenGLES 3.0 support in retroarch and libretro cores\n* **retroarch-opengl** - enable for OpenGL \u003e= 2.0 support in retroarch and libretro cores\n* **vulkan** - enable for Vulkan support in retroarch and libretro cores\n\n## Customizable variables\n\nThere is a collection of variables that can be set in *local.conf* or *distro.conf*:\n\n#### Default drivers\n* **RETROARCH_DEFAULT_INPUT_DRIVER** - default is udev\n* **RETROARCH_DEFAULT_JOYPAD_DRIVER** - default is udev\n* **RETROARCH_DEFAULT_VIDEO_DRIVER** - default is gl\n* **RETROARCH_DEFAULT_VIDEO_CONTEXT** - default is kms-egl\n* **RETROARCH_DEFAULT_AUDIO_DRIVER** - default is pulseaudio or alsathread\n* **RETROARCH_DEFAULT_RESAMPLER_DRIVER** - default is sinc\n* **RETROARCH_DEFAULT_MENU_DRIVER** - default is ozone\n\n#### Configuration\n* **RETROARCH_CONFIG_FULLSCREEN** - default is true, go for fullscreen mode, this respects initial resolutions (tested with rpi4)\n* **RETROARCH_CONFIG_THREADED_VIDEO** - default is true, use another thread for renderer\n* **RETROARCH_CONFIG_AUDIO_LATENCY** - default is 256, stock value is 64, I got better performance with higher values on rpi platforms\n\n#### Video settings\n* **RETROARCH_CONFIG_FONT_SIZE**\n\n#### Themes\n* **RETROARCH_CONFIG_XMB_SHADOWS**\n* **RETROARCH_CONFIG_XMB_THEME_COLOR**\n* **RETROARCH_CONFIG_XMB_THEME_INDEX**\n\nFor more information see file: [retroarch.inc](recipes-retroarch/retroarch/retroarch.inc)\n\n## Layer dependencies\n\n| Layer                                                                            | Sublayer           | Required           | Software           | Recommended BSPs   |\n|:---------------------------------------------------------------------------------|:-------------------|:------------------:|:------------------:|:------------------:|\n| [openembedded-core](https://github.com/openembedded/openembedded-core)           | meta               | :heavy_check_mark: | :heavy_check_mark: |                    |\n| [meta-openembedded](https://github.com/openembedded/meta-openembedded)           | meta-oe            | :heavy_check_mark: | :heavy_check_mark: |                    |\n| :arrow_right_hook:                                                               | meta-multimedia    | :heavy_check_mark: | :heavy_check_mark: |                    |\n| :arrow_right_hook:                                                               | meta-python        | :heavy_check_mark: | :heavy_check_mark: |                    |\n| :arrow_right_hook:                                                               | meta-networking    | :heavy_check_mark: | :heavy_check_mark: |                    |\n| [meta-qt5](https://code.qt.io/cgit/yocto/meta-qt5.git)                           | .                  | :heavy_check_mark: | :heavy_check_mark: |                    |\n| [meta-kodi](https://github.com/dev-0x7C6/meta-kodi)                              | .                  |                    | :heavy_check_mark: |                    |\n| [meta-raspberrypi](https://github.com/agherzan/meta-raspberrypi)                 | .                  |                    | :heavy_check_mark: | :heavy_check_mark: |\n| [meta-raspberrypi-extras](https://github.com/dev-0x7C6/meta-raspberrypi-extras)  | .                  |                    | :heavy_check_mark: | :heavy_check_mark: |\n| [meta-intel](http://git.yoctoproject.org/cgit/cgit.cgi/meta-intel/tree)          | .                  |                    | :heavy_check_mark: | :heavy_check_mark: |\n| [meta-rockchip](http://git.yoctoproject.org/cgit/cgit.cgi/meta-rockchip)         | .                  |                    | :heavy_check_mark: | :heavy_check_mark: |\n\n\n## Patches\n\nPlease submit patches against the [dev-0x7C6/meta-retro](https://github.com/dev-0x7C6/meta-retro) layer by pull requests.\n\n## Adding the meta-retro layer to your build\n\nIn order to use this layer, you need to make the build system aware of\nit.\n\nAssuming the meta-retro layer exists at the top-level of your\nyocto build tree, you can add it to the build system by adding the\nlocation of the meta-retro layer to bblayers.conf, along with any\nother layers needed. e.g.:\n```\nBBLAYERS ?= \" \\\n  /path/to/yocto/meta \\\n  /path/to/yocto/meta-yocto \\\n  /path/to/yocto/meta-yocto-bsp \\\n  /path/to/yocto/meta-retro \\\n\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdev-0x7c6%2Fmeta-retro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdev-0x7c6%2Fmeta-retro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdev-0x7c6%2Fmeta-retro/lists"}