Lime3DS/README.md

<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`) or you can alternatively download Obtanium from the [F-Droid](https://f-droid.org/) app store
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

# 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.

# 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)