Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »


1.0.50 • Public • Published


Bottlenose is a high quality front-end launcher for video game emulators! Available on Linux, macOS, and Windows!
Download Bottlenose and please choose an amount to pay for it

A what?

A front-end or user interface (UI) is the presentation and interaction layer of an app or website. Most modern emulators have basic game list UIs that you can interact with using a mouse or keyboard but not a game controller.

Bottlenose looks similar to media viewers like Kaleidescape and AppleTV. You can interact with it using a mouse or game controller. Unlike other front-ends, Bottlenose has a minimalistic design that prioritizes box art, not metadata. Check out the screenshots below!


  • unified UI for mouse/gamepad interaction
  • designed for UHD displays and projectors
  • scrapes multiple database sites for the highest quality box art
  • nostalgic UI themes for each supported console
  • launch games fullscreen (for emulators that support this option)
  • fancy reverse scroll effect on alternating rows in cover view mode
  • uses individual emulators: no cores and no controller input transfer lag
  • controllers connect to Bottlenose automatically, no setup required
  • browse demo mode if don't have any games on your computer
  • advanced customization made easy, edit launch commands and swap images
  • the only high quality front end to support Linux, macOS, and Windows!

Supported Emulators

Dolphin (Wii, Gamecube, Virtual Console) [Linux, macOS, & Windows]

Cemu (Wii U) [Windows & Linux* using Wine]

Yuzu (Switch) [Linux & Windows]

Citra (3DS) [Linux, macOS, & Windows]

DeSmuME (DS) [Linux, macOS & Windows]

Xenia (Xbox 360) [Windows]

RPCS3 (PS3) [Linux & Windows]

PCSX2 (PS2) [Linux, macOS, & Windows]

Please consider donating!

Even though Bottlenose is open source software that's free to use, it still took a lot of work and a long time to develop. If you appreciate my work so far and will continue to use this app please donate an amount of your choosing. I need your support to develop new features. Thank you!

Monthly Donations:
Patreon: https://www.patreon.com/qashto

Single Donation:
Paypal: https://www.paypal.me/qashto/25

Planned Features!

I want to make Bottlenose a full companion app for Dolphin and other emulators, not just a nice front-end. If enough people are interested in Bottlenose and donate enough, I will be able to set aside the time to implement these features!

  • create a database of Dolphin texture packs
  • batch install and auto-update texture packs for Dolphin
  • install emulators
  • automatic emulator updates for emus that lack this feature
  • easy way to mix and swap texture packs for Dolphin
  • list style view mode for browsing through box sides, useful for very large game libraries
  • instant autocomplete search
  • user ability to make custom themes
  • mGBA support
  • support for modded game isos/roms (currently skipped during indexing)

How is Bottlenose different from other front-ends?

Emulation Station is a nice front end for Windows and Linux. Like Bottlenose, it's open source! I was inspired by Emulation Station when I started working on Bottlenose. However, with Bottlenose I wanted to make box art the primary, practically singular, focus of the UI, not metadata or descriptions.

The most popular front end for Windows is Launchbox. If Launchbox's design is a bit too hectic for you then you might like the simplicity of Bottlenose! Launchbox looks useful for old arcade titles and seems like it's ready to run in custom arcade cabinets and on PCs with older hardware. It shoots for quantity over quality image wise which makes sense for giant arcade game libraries. Also, a lot of the game cover screens erroneously contain in-game or promotional art for a different game. For example in the promotional video, Super Smash Bros. for N64 has Brawl character renders behind it. Maybe that's not a big deal for most people but I don't like that. Overall, I like Launchbox and Bottlenose is not intended to replace it. Launchbox has support for so many emulators and numerous impressive features. Instead, Bottlenose will mainly focus on mature emulators of consoles released after the year 2000. Screenshot is of the "Big Box" mode of Launchbox.

OpenEmu for macOS is a great app for making controller profiles consistent among different emulator cores. It looks like dark mode Finder. I use it on my Macbook on plane flights and I like it. The covers are low-res, grid spacing is too wide though.

Windows Explorer, despite not having gamepad support, is also surprisingly popular for some reason. I've seen reddit posts with tutorials on how to make individual executables that launch emulators with a particular game. I think that's a pretty bad substitute for a dedicated launcher app.

Retroarch is not really comparable to Bottlenose. It uses seperate cores instead of individual emulator apps. Game art is low res and the interface is barebones. Good for small devices but personally I would never use it.

Steam is an ugly mess on UHD displays and if you're reading this you've probably used it already. I'm not going to include a screen shot here. You're welcome.

Using Bottlenose

Unlike Steam, Bottlenose does not send controller input to emulators. Therefore there is no lag caused by using Bottlenose. Bottlenose auto detects controllers, no setup is required. The default controller button mapping profile is Xbox_PS_Adaptive. If you're using a Nintendo controller switch to Nintendo_Adaptive in your preferences file.

The console themed plastic cover overlay menu displays the basic options on any given screen. On any game lib view you can press the "Start" button on your controller or click "Bottlenose" on the overlay to access the settings menu. If you've added new games to your game libraries "Reset" will reload the lib viewer. "Open" will pull up a menu with a list of game consoles. Select a console to open your game libraries for that console. "Power" starts the console emulator without a game.

Select a game from your game library to view it's cover. You'll see the overlay options change. Clicking "Play" will play the game. "Flip" doesn't do anything right now.

What is Adaptive Button Mapping?

// Xbox/PS Adaptive profile usage example:

// User is currently browsing their Nintendo Switch library
// Xbox One controller is mapped to
// Nintendo Switch controller button layout
//  Y B  ->  X A
// X A  ->  Y B

// User is browsing Xbox 360 games so no mapping occurs
//  Y B  ->  Y B
// X A  ->  X A

// User is browsing PS3 games so no mapping occurs either
// since Xbox One has the same mapping as PS3
//  Y B  ->  △ ○
// X A  ->  □ X

Although some may find this confusing at first, adaptive profiles map the button layout of your controller to match the button layout of controllers made for whatever system you're browsing. In the NTSC region, Xbox and Playstation use the bottom button of the face button diamond as the "yes" or "make selection" button. Starting with the SNES the B button has been at the bottom of the layout diamond on Nintendo controllers that have a standard button layout. The B button on Nintendo systems means "no" or "back". The default profile remaps from Xbox and PlayStation button layouts to Nintendo's button layout when browsing Nintendo system libraries. This mapping will occur when browsing Nintendo game libraries only. On PS and Xbox game libraries Xbox_PS_Adaptive does not remap buttons.

Hence by using an "Adaptive" profile you will always be using the physically correct button layout for the system library you're browsing, regardless of what controller you use!

I recommend using adaptive mapping in your emulator controller settings too. This way you can play games using the button layout that game developers intended even if you're using a controller made for a different system.

The other included gamepad mapping profile types are "Consistent", for non-adaptive remapping between controller types and "None", for no mapping, which is not recommended. You can easily change between these options by editing your preferences file. Set ui.gamepad.profile to your desired controller profile. If for example, you're using a Nintendo Switch controller, you should use Nintendo_Adaptive.

System Requirements

Bottlenose will probably not perform well on low-end systems. Ultra high resolution images require more storage and animations using these images require strong GPUs. Although, I've tested Bottlenose on my 2016 Macbook with a 1.1GHz CPU with onboard Intel HD 515 graphics and it runs at 2304x1440 without any bad stuttering.

Setting up Bottlenose

If you do not want to use the optional template file structure, simply select "continue" on the setup page. Bottlenose will prompt you for the location of your game directories. It may also prompt for the emulator app before you launch a game with Bottlenose for the first time. Setup as you go and Bottlenose will save these locations in your preferences file.

OPTIONAL Template File Structure

emu (root folder can have any name)
├─┬ Dolphin
│ ├─┬ BIN
│ │ ├── User/...
│ │ ├── portable.txt
│ │ ├── Dolphin.exe
│ │ └── ...
│ └─┬ GAMES
│   ├── Super Mario Sunshine.gcz
│   ├── Super Smash Bros Melee.iso
│   └── sm64.wad
└─┬ Cemu
  ├─┬ BIN
    │ ├── Cemu.exe
  │ └── ...
  └─┬ GAMES
    └─┬ Mario Kart 8 (game folder)
      └─┬ code
        └── Turbo.rpx

Bottlenose was designed to optionally use the same directory structure as WiiUSBHelper, for compatibility. Although WiiUSBHelper is no longer maintained, Bottlenose will continue to use this structure as the template. The default game library of each emulator will be its GAMES folder. As an exception, Bottlenose will default to the internal game library of emulators that store games in file structures meant to mimic the system being emulated. For example, RPCS3 has an internal game library that will be located at emu/RPCS3/BIN/dev_hdd0/game.

On windows, the auto-updater for yuzu doesn't let users pick yuzu's location. This is okay, Bottlenose will default to the location that the installer uses instead of emu/Yuzu/BIN.

On macOS, Bottlenose looks for your emu apps in Applications/.

On Linux, Bottlenose knows how to use apps via the command line and will prompt you for the location of other emu apps.

User Preferences

region game files without game IDs in their game file name, for example "Super Smash Bros Melee.iso", will be auto assigned to a default region. Use E for North and South America, P for European PAL, J for Japan.

ui.mouse.wheel.smoothScroll = false on Windows by default, should be true if you have a mouse that supports smooth scrolling (like an Apple Macbook trackpad)

ui.mouse.wheel.multi it's a multiplier that changes the scroll amount.

ui.getBackCoverHQ get's the back of the box in high quality for games without available full covers

ui.recheckImgs when true, on reset, images will be scraped for all games in the given library, not just new games

session.sys the last game library viewed, Bottlenose will load this library on start-up next time the app is run

gamepad.profile the controller profile you want to use

[sys].cmd.[os] the launch command for that game system and os

Advanced Features: Custom Launch Commands

Edit your preferences file to change the default launch command for each OS. This is an example of Cemu's command object:

"cmd": {
    "linux": ["wine", "${app}", "-g", "${game}", "-f"],
    "win": ["${app}", "-g", "${game}", "-f"]

Error Reporting

Please send me send me a description of any errors with the relevant error log or report an issue with the code on this project's Github.

Mismatched or Unidentified Games

If Bottlenose has trouble matching your game file name, please take a look at the error log. This can be easily accessed in the Bottlenose menu. This file will tell you which game files are unidentifiable or lead to incorrect matches. Give these files the proper game title or game ID and Bottlenose will be able to find matches in its game databases.

Mismatched or Unidentified Game Hacks

Bottlenose doesn't support game hacks (fully) yet. In the future, I think I will use the game's original cover and put a sticker on it with the name of the hack.

Missing Cover Art

As of version 1.0.44, Bottlenose should be able to get all your game images. If Bottlenose can't find images for a game in the Bottlenose database you can put cover art in emu/bottlenose/{sys}/{GAMEID}/img. For more info see the "Images" sections of this README.

Contributing to Bottlenose

You can contribute to Bottlenose to add to and update existing game databases, make a PR or email me mailto:qashto@gmail.com with your new or updated entries. Game database JSON files can be found in the db folder. Game entries are structured like this:

 "id": "G8ME01",
 "title": "Paper Mario: The Thousand-Year Door",
 "texp": [{
     "name": "HD",
     "authors": ["The Dolphin Community"],
     "rate": 10,
     "version": "1.7.0",
     "png": ["https://drive.google.com/file/d/1QtgZFz2darznGNtViJVOep8UZ3xuaUkN/view?usp=sharing"],
     "dds": ["https://drive.google.com/file/d/1x6XJnQTW9SvbA6EmNHIKz9bGDXXweHAD/view?usp=sharing"],
     "url": ["https://forums.dolphin-emu.org/Thread-paper-mario-ttyd-hd-texture-pack-v1-7-july-4-2018"]

Game Properties

  • id is the official id of the game
  • name the official name of the game, subtitles are delineated using a colon
  • texp the texture pack array, order is irrelevant
  • img an object with "imageKind": "image/url" pairs that override the default scrape location

Texture Packs

  • authors usernames or real names of the author(s)
  • name should be short and simple, such as "UHD" or "Blue Edition"
  • png and dds link(s) to direct download the pack
  • pngRP and ddsRP link(s) to resource pack for Dolphin
  • url link(s) to the relevant forum post or readme
  • version the semantic version of the pack
  • rate the pack's rating 1-10
  • patron donation link(s) to the author(s) of pack


The following names can be used to specify images:

  • box the front cover including the box
  • boxBack the back cover including the box
  • coverFull the entire cover sleeve, no box
  • cover the front facing portion of the cover sleeve, no box
  • coverSide the side facing portion of the cover sleeve, no box
  • coverBack the side facing portion of the cover sleeve, no box
  • disc the front of the game's (first) disc
  • cart the front of the game's (first) cartridge

Box art scraping is prioritized in this order: box (highest quality), coverFull, cover, box (low quality). In a future version of Bottlenose users will be able to change images in the UI. For now, you can add them in the game's img object like this:

  "id": "ALERA",
  "title": "Mario Tennis Aces",
  "img": {
    "box": "https://images-na.ssl-images-amazon.com/images/I/91TvX36nF-L.jpg"

Planned Features! (continued)

Texture packs with a rating of 7 and above will be considered recommended. In a future version of Bottlenose, users will be able to batch install all the recommended packs for their entire game library. The highest ranking pack for each game will become the default pack and placed in User/Load/Textures. Users will still be able to install non-recommended packs individually in the app. Incompleteness of a pack has no bearing on a pack's rating. Pack ratings will be curated by me (quinton-ashley/qashto) and based on the Dolphin forum's democratic star rating and opinions from other texture pack creators. The vast majority of packs currently on the Dolphin forums will receive a 8-10.


Here are some answers to common questions about Bottlenose. I've also responded to complaints in an effort to anticipate and mitigate toxic arguments about Bottlenose. I would prefer to facilitate respectful discussions on community forums like r/emulation. I'm not bitter but I work on this project in my free time and it's open source cause I want to share it with people for free. I'm not afraid of criticism either. Suggestions and feedback can be really helpful for the continued development of Bottlenose but hateful, toxic, or un-constructive criticism is not acceptable.

Bottlenose is not the procedural outcome of a greedy, monolithic corporation, it's the creation of a single human, me (qashto), so I'm going to take it personally if you hate on it.

"Nice app! Why did you decide to make Bottlenose?"

I wanted a simple, unified app for launching games with any modern emulator just by using a game controller to browse game boxes. After I found Andy Decarli's site I knew I could make Bottlenose stand out as a UHD app. Andy's scans are so high res you can see the printer color dot patterns distinctively. There's a real sense of physicality to them. I think Bottlenose succeeds in providing a digital version of the experience of browsing through game boxes and not little game art thumbnails surrounded by wasted space, text, and metadata. Compared to the boxless digital download product pages on modern online game shops, I think it's an appropriately nostalgic way to browse these games.

Another primary goal of mine, as a pretty amateur texture pack creator, was to make an auto-installer/updater/manager for dolphin texture packs, hence the name Bottlenose. There are so many incredible texture packs that I feel are going unappreciated cause people don't know about them. When I announced Bottlenose I posted this idea in a comment on Reddit but hadn't implemented it yet. Luckily for me, my idea inspired a Dolphin dev to build a texture pack manager into Dolphin officially! I'm waiting for that to be finished and hopefully it'll accept command line input.


"If you don't change {x} about Bottlenose, I'll never use it and I hope you fail!"

I'm not afraid to call people out for being rude and entitled. There are better ways to phrase your thoughts.

Something is missing or obviously flawed and I probably already have plans to do it:
"Are you going to do {x} in the future?"

Something goes wrong:
"I had a problem with Bottlenose. Could you please help me/fix it?"

You want to help:
"I'd like to help you fix an issue with Bottlenose."

You choose to support me financially:
"I'm a Patreon supporter and I justifiably feel entitled to {x}."

"Bottlenose is a bad name!"

Yes the app has quickly outgrown it's original purpose of being a Dolphin companion app. Unfortunately, I'm attached to the name and it's not going to change.

"Your logo is trash, I hate it!"

I'm not a professional artist, I'm a programmer. Vaporwave art subverts the kind of commercially successful aesthetics of the past in a nostalgic, playful way. Visual vaporwave art often utilizes neon cyan and hot pink colors and strange, often wavy textures. Typically, this art form is not meant to be taken super seriously or analyzed from a commercial design perspective. I think the full logo and app icon both embody the vaporwave ideology and aesthetic. I had fun making the logo and I personally like the outcome.

Development Info

Bottlenose is open source and MIT licensed! I loved using Electron to make Bottlenose. I highly recommend it to devs interested in creating native desktop apps with node.js. Bottlenose is written in good ol', no-types-allowed javascript and proudly uses Pug, jQuery, Bootstrap, and Contro.

Contributing to Bottlenose (code)

PRs are welcome! Please follow my coding style though. No callback pyramids, use Async/Await whenever possible. Do not write plain JS novels when editing the DOM, just use jQuery please. I will be changing more of the code to make contro-ui a separate package at some point.


Obviously, Bottlenose wouldn't exist without the developers of these emulators. Please support the devs of emulators you use! Bottlenose uses publicly available images under Fair Use.


The logo is a vaporwave style variation on MayImilae's Dolphin logo


gametdb database text files

Game Box and Disc Art

The highest quality box scans are from Andy Decarli!

Full covers, boxes, discs/carts are scraped from gametdb

Some covers scraped from gamefaqs with puppeteer

Some full resolution product images from Amazon are used for Wii U and Switch titles.

Template Art

  • Gamecube, Wii, and Wii U templates by etschannel via deviantart
  • Switch template by ponces245 via deviantart
  • PS3 template by the_prototype92 via deviantart
  • 3DS template by omegaaaronyt via deviantart
  • Xbox 360 template by georgiajedward via deviantart


As of yet, all themes were made by me (quinton-ashley/qashto)

CSS PlayStation button icons adapted from a CodePen by Hugo Giraudel

Loading Sequences

Gamecube Intro by MarcMalignan : MIT licensed

DS by Murat Khatypov

Switch Pure CSS by joshbader : MIT licensed

Wii U Gamepad SVG by Tokyoship from Wikimedia Commons : Creative Commons Attribution 3.0 Unported

3DS SVG image trace by me (quinton-ashley/qashto)

Xbox 360 Loading Intro by Girish Sharma

PS3 Icon Loader by Jan Machycek



Legal Disclaimer

Although Emulation is legal, pirating games you do not own is illegal. Bottlenose does not condone piracy. Bottlenose is open source software that does not infringe on any copyrights of texture packers, developers, or publishers. Bottlenose is not affiliated with Nintendo, Sony, or Microsoft. Anyone asking for or sharing information related to digital piracy on this project's Github issues will have their comments removed and flagged.



npm i bottlenose

Downloadsweekly downloads










last publish


  • avatar
Report a vulnerability