RetroDECK/README.md

79 lines
5.4 KiB
Markdown
Raw Permalink Normal View History

<p float="center">
<img src="https://github.com/XargonWan/RetroDECK/blob/main/res/logo.png?raw=true" alt="RetroDECK logo" width="600"/>
</p>
2022-11-02 08:10:03 +00:00
![Flathub](https://img.shields.io/flathub/downloads/net.retrodeck.retrodeck)
![Flathub](https://img.shields.io/flathub/v/net.retrodeck.retrodeck)
2022-04-26 10:16:15 +00:00
![Discord](https://img.shields.io/discord/951662718102962256?label=discord)
![GitHub](https://img.shields.io/github/license/XargonWan/RetroDECK)
2023-08-28 14:29:16 +00:00
[![Documentation Status](https://readthedocs.org/projects/retrodeck/badge/?version=latest)](https://retrodeck.readthedocs.io/en/latest/?badge=latest)
2022-04-26 10:16:15 +00:00
2023-04-18 09:05:14 +00:00
# RetroDECK on your device!
2022-03-14 10:40:49 +00:00
2023-06-02 06:01:32 +00:00
<p float="center">
<img src="https://github.com/XargonWan/RetroDECK/blob/main/res/screenshots/screen03.jpeg?raw=true" alt="screenshot" width="300"/>
<img src="https://github.com/XargonWan/RetroDECK/blob/main/res/screenshots/screen04.jpeg?raw=true" alt="screenshot" width="300"/><br/>
<img src="https://github.com/XargonWan/RetroDECK/blob/main/res/screenshots/screen05.jpeg?raw=true" alt="screenshot" width="300"/>
<img src="https://github.com/XargonWan/RetroDECK/blob/main/res/screenshots/screen06.jpeg?raw=true" alt="screenshot" width="300"/>
</p>
<br/>
2023-04-18 10:59:02 +00:00
## What is RetroDECK?
2023-06-02 06:01:32 +00:00
RetroDECK is a [EmulationStation Desktop Edition](https://es-de.org) powered application that builds in a variety of emulators and other software that allows you to play your favorite retro (and even not-so-retro) games in a tidy contained flatpak sandbox environment. It's inspired by embedded emulation systems like AmberELEC, EmuELEC, CoreELEC, Lakka, and Batocera.
2023-04-18 10:59:02 +00:00
2023-06-02 06:09:35 +00:00
You can also check out our: [Flathub Page](https://flathub.org/apps/net.retrodeck.retrodeck)<br/>
2023-06-22 05:18:26 +00:00
## What devices/systems does RetroDECK support:
2023-06-22 04:53:20 +00:00
### Steam Deck
2023-06-22 05:23:39 +00:00
Supported from the start and RetroDECK is tailored to the Steam Deck during the beta period. The goal is that all the configurations are ready out-of-the-box and optimized towards the Steam Deck.
2023-06-22 04:53:20 +00:00
### Linux Desktop
Technically it is working, but the user experience might not be that great it could contain desktop specific bugs and other issues.
You will also need to manually configure the input to match your desktop and might need to tweak more settings. If you want to try it make sure that your distribution has flatpak support (else you will need to install it).<br>
We will start to have a bigger desktop focus after the beta period is over.
2023-06-22 04:53:20 +00:00
2023-06-22 04:55:46 +00:00
### Other SteamOS or Linux handheld gaming devices with flatpak support
2023-06-22 05:18:26 +00:00
We do plan to support other SteamOS based devices in the future. But during the BETA we are focusing on the Steam Deck.<br/>
You can get it to run on other Linux based devices it is not just as seamless as we want it to be and does not live up to our higher standards.<br/>
You will need to manually configure the input to match your device and might need to tweak more settings if you try it on a none Steam Deck device. There might also be some hardware specific bugs.
2023-06-02 06:01:32 +00:00
2023-06-22 05:25:51 +00:00
## Do you have any plans for other systems?
2023-08-25 14:38:25 +00:00
RetroDECK does not have plans to support Windows, macOS, Android, or iOS.<br>For similar functionality on Windows you could explore [Retrobat](https://www.retrobat.org/) as an alternative.
2023-06-02 06:02:21 +00:00
2023-06-22 04:53:20 +00:00
## How do I install RetroDECK?
2023-06-02 06:02:21 +00:00
Read and follow the guide here: [Installation instructions](https://github.com/XargonWan/RetroDECK/wiki/How-to:-Getting-started) on the Wiki
2023-06-02 06:01:32 +00:00
## The RetroDECK community:
2023-08-19 19:24:44 +00:00
2023-06-02 06:01:32 +00:00
[Website](https://retrodeck.net) <br/>
[Wiki](https://github.com/XargonWan/RetroDECK/wiki) <br/>
[Discord](https://discord.gg/Dz3szYsP8g)<br/>
2023-08-19 19:24:44 +00:00
[Lemmy](https://lemmy.zip/c/retrodeck)<br/>
2023-06-02 06:01:32 +00:00
[Subreddit](https://www.reddit.com/r/retrodeck)
2023-04-18 06:54:25 +00:00
# Short FAQ
2022-03-14 10:40:49 +00:00
2023-04-18 06:54:25 +00:00
Please read the [Wiki](https://github.com/XargonWan/RetroDECK/wiki) for even more information.
## Do I have to partition or format my disk/sdcard to install it?
2023-04-18 10:33:03 +00:00
No, partitioning or formatting is not needed at all. RetroDECK (differently from AmberELEC, Batocera and others) comes as a flatpak. Just install it as any other application and launch it from your desktop and/or Steam library.
2022-03-26 22:36:43 +00:00
2023-04-18 06:54:25 +00:00
## Can I contribute to the project?
Yes! Everybody is welcome to contribute in any way possible if it is personal time or funds, just check out our [Discord](https://discord.gg/Dz3szYsP8g)!
- Do you know how to code and want to contribute? Please join the development team!
- Maybe you know graphics, art or UI & UX design? Join the discussion!
- You can just help by helping others in the support or guide people on various social media and communication platforms.
- You can also help by just finding and testing the best configurations for the emulators and the roms.
- Or just help us by doing bug reports on all the issues you find (please check old issues first before submitting a new one).
- By joining the ✨-new-helpers-start-here channel on [Discord](https://discord.gg/Mv3GZnwrE8) and keeping an eye on the [issues](https://github.com/XargonWan/RetroDECK/issues) tab as well as the [Roadmap](https://github.com/XargonWan/RetroDECK/milestones) tab, you can be up to speed on the latest developments on RetroDECK.
2023-04-18 06:54:25 +00:00
- We have a [Patreon](https://www.patreon.com/RetroDECK) page if you want to help us keep our build servers running or just buy us a beverage
2022-05-22 14:13:26 +00:00
2023-04-18 09:07:13 +00:00
###### The Steam Deck logo is a registered trademark of Valve Corporation. This project is in no way officially affiliated with Valve.<br/>
2023-04-18 06:56:35 +00:00
2023-04-18 09:07:13 +00:00
###### All trademarks, logos and brand names are the property of their respective owners. All company, product and service names used in this project are for identification purposes only. Use of these names, trademarks and brands does not imply endorsement.