Lime3DS/README.md
2024-05-27 14:59:34 +01:00

76 lines
3.5 KiB
Markdown

<h1 align="center">
<br>
<a href="[https://github.com/Lime3DS]"><img src="https://raw.githubusercontent.com/Lime3DS/Lime3DS/1b1c4f29d4280c750702459fd9a6ada539a4e9a9/dist/lime.svg" alt="Lime3DS" width="200"></a>
<br>
<b>Lime3DS</b>
<br>
</h1>
![GitHub Release](https://img.shields.io/github/v/release/Lime3DS/Lime3DS?label=Current%20Release)
![GitHub Downloads](https://img.shields.io/github/downloads/Lime3DS/Lime3DS/total?logo=github&label=GitHub%20Downloads)
![Flathub Downloads](https://img.shields.io/flathub/downloads/io.github.lime3ds.Lime3DS?logo=Flathub&label=Flathub%20Downloads)
![](https://github.com/Lime3DS/Lime3DS/actions/workflows/build.yml/badge.svg)
<b>Lime3DS</b> is a project which aims to revive and continue work on Citra, a popular open-source Nintendo 3DS emulator which ceased development.
# Installation
### Windows & MacOS
Download the latest release from [Releases](https://github.com/Lime3DS/Lime3DS/releases).
---
### Android
The recommended method of downloading Lime3DS on Android is via Obtainium:
1. Download and install Obtainium from [here](https://github.com/ImranR98/Obtainium/releases) (use the file named `app-release.apk`)
2. Open Obtainium and click 'Add App'
3. Type `https://github.com/Lime3DS/Lime3DS` into the 'App Source URL' section
4. Click 'Add'
5. Click 'Install' (or 'Update' if you have an existing APK install)
6. Lime3DS is now ready to use
Using Obtainium will allow for quick and easy installation of updates.
\
\
\
Alternatively, you can install the latest APK from the [Releases](https://github.com/Lime3DS/Lime3DS/releases) page.
This will require a new APK to be manually downloaded each time an update is released.
---
### Linux
Lime3DS is available as an AppImage on the [Releases](https://github.com/Lime3DS/Lime3DS/releases) page.
We are also on Flathub:
<a href=https://flathub.org/apps/io.github.lime3ds.Lime3DS><img width='180' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/></a>
# Build Instructions
Please refer to our website's [wiki](https://lime3ds.github.io/pages/wiki.html) in order to find building instructions for Windows, Linux, Android and MacOS
# Compatibility Reporting
Reports for game compatibility can be made here: https://github.com/Lime3DS/compatibility-list
Please ensure that you have read the contributing document before submitting a report.
# What's next?
We keep a public roadmap of what features/bug fixes are planned to be included in the next update or two.
You can find this at https://github.com/Lime3DS/Lime3DS/milestones.
# How can I contribute?
If you believe you can help with this project, please lend us your talent! We're a team of passionate enthusiasts who need all the help we can get.
If there is an issue you want solved or a feature you want implemented, feel free to open a pull request.
<sup>(Please don't repeatedly merge `master` into your PR's branch. A maintainer will update the branch for you if/ when it is appropriate to do so)</sup>
Additionally, [we are accepting language translations on Transifex](https://app.transifex.com/lime3ds/lime3ds). If you know a non-english language listed on our Transifex page, please feel free to contribute.
Note: We are not currently accepting new languages for translation. Please do not request for new languages or language variants to be added.
# Discord
Join our Discord community to discuss the project or talk with the developers.
[![](https://dcbadge.vercel.app/api/server/4ZjMpAp3M6)](https://discord.gg/4ZjMpAp3M6)