Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

253 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Emulair Emulator

Get it on Google Play Get it on F-Droid Get it on GitHub

Details

Emulair is an Android exclusive open-source front-end for Libretro cores, based on Lemuroid. For more information about the project (such as how the code functions, why the project exists, who worked on it, etc.), check the Wiki page. To see our backlog, check the Projects page. Our old backlog (before transferring Emulair to this organization) can be found here: https://github.com/users/RaduBratan/projects/2/. Note that you should access the first link for the most up-to-date backlog.

Philosophy

The primary goal of Emulair is to combine the ease of use and simple but accessible interface of Lemuroid with RetroArch's extensive customizability and features, while also adding support for standalone emulators.

Origin

It originates from Lemuroid, which, in turn, is a rib of Retrograde. It also uses LibretroDroid under the hood to run Libretro cores. The 2D sprites for the systems are taken from hakchi2 and Faustbear.

Systems - Libretro Cores

Note: Emulator1 and Emulator2 means you can't choose between them because they are combined, Emulator1 or Emulator2 means you can switch the cores.

Systems - Standalone Apps

Note: This feature hasn't been implemented yet.

Existing Features (from Lemuroid)

  • Easily search for any installed video game
  • Manually save/load states
  • Automatically save/load states when correctly closing a game (by clicking "Quit" in the pause menu)
  • Add games to a "Favourites" list
  • Simulate various screens, such as LCD or CRT
  • Remap some touch screen controls (such as joysticks or D-pads) to gyroscopic input, by double/triple tapping the buttons
  • Customizable touch controls (size and position)
  • ROMs scanning and indexing
  • BIOSes scanning and indexing
  • Gamepad support (with button remapping included)
  • .zip ROMs support
  • Local, offline multiplayer support (up to 4 controllers, only in games where you can select more than one player)

Added Features

  • Complete visual redesign with consistent sizing, spacing and corner radius
  • Complete conversion to Material Design 3 Components
  • An easier to navigate app structure
  • An info screen containing frequently asked questions and other useful stuff
  • A profile screen used for easily connecting to RetroAchievements
  • A "Close menu" button accessible from the pause menu, so users don't have to click their device's back button every time they want to unpause a game
  • A themed app icon for Android 13+ devices
  • A "Jump back in" section on the "Games" page, along with "Recents", "Favorites" and "All Games"
  • Separate screens with vertical lists for "All Games" and "Favorites" (i.e. they're not just horizontal carousels anymore)
  • Button prompts before (almost) every important action
  • New dark theme, light theme and system default theme
  • New in-app icons
  • New sprites for systems
  • Bypass screen lock to rotate the screen whenever you want
  • Automatically rescan internal directories on app restart and resume
  • Sync save files with Google Firebase (added in separate branch)
  • Fixes for bugs that were carried over from Lemuroid
  • Plenty QOL features, updates and fixes

Upcoming Features

  • Complete rewrite in Jetpack Compose (my only priority this year)
  • More emulation cores (almost all cores found on RetroArch)
  • More exposed settings for all the cores
  • More state slots
  • More save file formats support
  • More animations and effects
  • More controls customization (e.g. hide any button, move buttons anywhere on the screen, etc.)
  • Better ROM scraping and name detection
  • Better NDS/3DS touchscreen controls (they can now overlap the screens)
  • Cheat codes support
  • RetroAchievements support
  • .7z ROMs support
  • Save/load state undoing/redoing support
  • Search filters support
  • Full phone sensors support (i.e. emulators can now take advantage of tilt sensors, cameras, microphones, etc.)
  • File saving to storage/emulated/0
  • Automatic state saving every x seconds
  • Custom touchscreen gamepad transparency
  • Custom volume, fast forward speed and vibration strength
  • Different app layout for tablets and foldables
  • Different app layout for phones in landscape orientation
  • An updated Libretro games database with more fields (e.g. release year, release month, etc.)
  • A user-friendly intro screen concisely explaining how to use the app
  • A "Starred Systems" list
  • A details screen accessible by long-pressing a game or a system
  • A splash screen for Android 12+ devices
  • Set core on a per game basis
  • Choose if you want to automatically fall back on other emulators or not, in case a game doesn't work (this implies unlocking the option to switch between FinalBurn Neo and MAME 2003-Plus)
  • Change filter on a per game or per system basis (not just global)
  • Rebind controls on a per game or per system basis (not just global)

Note: The above features won't be released in this exact order. Some features may be changed or even removed from this list.

Removed Features (from Lemuroid)

  • Android TV support
  • Turn games into shortcuts for your launcher
  • Save files to Google Drive (only if downloaded from Google Play; Drive folder inaccessible)

Note: Some features will be brought back later.

Dropped Features (from Emulair)

  • Material You (Monet Engine) counterparts for all the themes (exclusive to A12+ devices)

Note: Some features will be brought back later.

Name Meaning

"Emulair" is a triple entendre and the name is inspired by the Lawnchair launcher (not associated with Emulair). Firstly, "Emulair" kind of sounds like the word "Emulator" (if you try hard enough). Secondly, "Emulair" means "lair of the emu bird", an animal whose name is similar to the abbreviation of the word "emulator". Lastly, "Emulair" also means "lair for all your emulators", which is similar in name to "Vimm's Lair", a place for preserving video games.

Legal

Copyright (C) 2023 Radu-George Bratan

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Before downloading the source code of this software to use it in a project (no matter if it's private or public), please make sure that you understand what the GNU General Public License v3.0 allows you, forbids you as well as requires you to do.

About

👾 An open-source emulator front-end based on Lemuroid

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages