pokemon-fulldex README

项目的 README,来自 github.com/mamesj/pokemon-fulldex。合并为一个 markdown 文件:README.md。

Pokémon Fulldex

All your favourite Pokémon games on a PC (Windows and Linux), a Mac, a Steam Deck or other handheld PC, an Android phone, an iPhone or iPad, or a modded Nintendo Switch: one screen, widescreen, 60 fps, up to 4K on a PC and 720p on the Switch. No more squinting at two tiny stacked DS screens.

DS: Black 2, White 2, Black, White, HeartGold, SoulSilver, Platinum, Diamond and Pearl.
GBA: Emerald, Ruby, Sapphire, FireRed, LeafGreen and Ultra Violet.
3DS (beta): Omega Ruby and Alpha Sapphire on Windows, Android and Switch; X, Y, Ultra Sun and Ultra Moon coming soon.
Which languages: Supported games.

Pokémon Fulldex: Black 2, White 2, Black, White, SoulSilver, HeartGold, Platinum, Diamond and Pearl, and the GBA games Emerald, Ruby, Sapphire, FireRed, LeafGreen and Ultra Violet, in widescreen at 60 fps on a PC, a Mac, a Steam Deck, an Android phone and a Nintendo Switch; RetroAchievements, cheats, save states and your own colour and background built in

Downloads

Where you play Download Install
Windows PC, and Windows handhelds (ROG Ally, Legion Go, MSI Claw) pokemon-ds-wide-pc-windows-x86_64.zip PC
Mac with Apple silicon (M1 and newer) pokemon-ds-wide-pc-macos-arm64.zip Mac
Mac with an Intel processor pokemon-ds-wide-pc-macos-x86_64.zip Mac
Linux (glibc 2.38+) and the Steam Deck pokemon-ds-wide-pc-linux-x86_64.tar.gz, or as an AppImage (Gear Lever) PC
Android phone (64-bit, Android 7 or newer) pokemon-ds-wide-android.apk Android
iPhone and iPad (iOS 14 or newer, sideloaded) pokemon-ds-wide-ios.ipa iPhone
Nintendo Switch (homebrew) pokemon-ds-wide-all-switch.zip Switch

One program per platform: start it and pick the game from the list. You bring your own ROMs: the downloads hold none of the games. What's new in each update: Releases.

What is it?

A program for your PC or your Switch (as homebrew) that runs the game on the melonDS emulator core (built in: there is nothing else to install), plus a layer that knows what the game is doing (which screen, which menu, which battle) and rearranges it into one proper widescreen picture. It is not a native port (those are the dream, see What's next); it's the DS game, presented the way it should look on a modern screen.

melonDS this
Screens two 256×192 DS screens, stacked or side by side one 16:9 picture, the touch screen's buttons tucked beside the action
3D world 4:3 at DS resolution 16:9, skies and scenery carried to the edges: up to 4K on a PC (your graphics card), 720p on the Switch (its graphics chip)
Frame rate the game's own 30 fps 3D 60 fps, with in-between frames

Supported games

Game Languages Notes
Black 2 / White 2 English, French, Spanish German, Italian, Japanese and Korean in beta
Black / White English, French, Spanish German, Italian, Japanese and Korean in beta
SoulSilver / HeartGold English, French, Spanish (and Italian HeartGold) German, Italian, Japanese and Korean in beta
Platinum English, French, Spanish German, Italian, Japanese and Korean in beta
Diamond / Pearl Diamond: English, Spanish, German, Italian. Pearl: English, French, Spanish, German, Korean Experimental
Emerald (GBA) English
Ruby / Sapphire (GBA) English (1.0, 1.1, 1.2), German, French, Spanish, Italian, Japanese
FireRed / LeafGreen (GBA) English (1.0, 1.1)
Ultra Violet (GBA, a FireRed hack) 1.22 as its .gba, or its .ips patch beside a FireRed 1.0 ROM
Omega Ruby / Alpha Sapphire (3DS) Every language on the cartridge Beta: Windows, Android and Switch (how); Mac, iPhone and iPad coming soon
X / Y, Ultra Sun / Ultra Moon (3DS) Coming soon

Install

On a PC, Mac, Steam Deck or handheld (Windows, macOS and Linux)

Show the guide

The game list: POKÉMON FULLDEX with the tabs ALL, DS, GBA and 3DS; scrolling down past the DS games (Black, White, Black 2, White 2, HeartGold, SoulSilver, Platinum) to the GBA games (Emerald, Ultra Violet, FireRed, LeafGreen) and Omega Ruby, COMING SOON; then each tab, and the settings page

  1. Download pokemon-ds-wide-pc-windows-x86_64.zip (Windows) or pokemon-ds-wide-pc-linux-x86_64.tar.gz (Linux). On Linux there is also an AppImage, the program as one file: add it to Gear Lever (or another AppImage manager) and it updates itself. Its ROMs, saves and settings go in ~/.local/share/pokemon-ds-wide (O in the game list opens its roms folder).
  2. Unpack it anywhere (not inside Program Files) and put your ROMs in its roms folder (any names).
  3. Start Pokemon Fulldex.exe (Linux: pokemon-ds-wide) and pick a game. Windows may warn about an unknown publisher the first time: choose "More info", then "Run anyway".

It starts in borderless fullscreen at 1080p with 60 fps; F11 switches to a window. In the game list, arrow keys or a controller choose, Enter or A plays, H (or a controller's Y) opens the settings and O opens the roms folder. While playing, Esc (or a controller's Start or Guide button) opens the pause menu; QUIT there goes back to the list.

Controls: any controller (Xbox, PlayStation, Switch Pro and others) plays as a DS; hold its right trigger to fast forward. On the keyboard: arrow keys, X/Z for A/B, S/A for X/Y, Q/W for L/R, Enter for START, Backspace for SELECT, the mouse for the touch screen, Left Shift to fast forward, F5 to save a state and F8 to load it. The README.txt inside has the full list. CONTROLS > KEYS AND BUTTONS in the pause menu (or on the game list's settings page) changes any of them, including fast forward, swapping the screens, save state and load state, on the keyboard and on a controller (the game list follows the ones you change).

Steam Deck trackpad: when launching through Steam, set the right trackpad to Mouse and its click to Left Mouse Click in the game's Steam Input layout. Keep the game buttons mapped as gamepad buttons. The pointer can touch the DS screen and click launcher, pause and GBA menus. In DS fullscreen it appears while used and hides after a short idle period. Layouts that also send keyboard shortcuts for the same gamepad buttons can produce duplicate input; the launcher combines matching actions received together. Direct trackpad behaviour outside Steam still depends on the controller driver and needs device verification.

Saves go in the saves folder, one per game (black2.sav, soulsilver.sav, platinum.sav, ...). To carry on from another emulator, put its .sav there under that name. Pictures: the list shows each game's box art; for your own, put a JPEG or PNG in an icons folder beside the program, named after the game's code (IREO.jpg for Black 2, see the README.txt). You can also open a game's menu and choose Change Picture > Import A Picture. On Linux and Steam Deck, use the folder browser to select a PNG or JPEG; on Windows, the system file picker opens. The chosen image is copied into the save folder, leaving your original picture alone. Games with the same filename can keep different pictures.

Launcher Settings > Display also lets you choose the DS Screen Filter or GBA LCD Effect before starting a game. GBA AUTO keeps its existing in-game choice; selecting ON or OFF overrides it. Changes in the in-game display menus are remembered by the launcher.

The settings page: its groups (DISPLAY, SOUND, GRAPHICS, CONTROLS, SHORTCUTS, GAME LIST, HELP), each with the options in it

Settings (all of them: Settings). The ones that matter most on a PC:

Setting Starts at What it does
3D RESOLUTION 1080P how sharp the 3D world is: 720P, 1080P, 1440P (2K) or 2160P (4K)
LOWER RES WHEN BUSY OFF ON: a lower resolution for a moment instead of slowing down
FAST FORWARD LOW RES OFF ON: 360P while fast forwarding, for more FPS on a slower PC
WORLD ON GPU ON the world drawn by your graphics card; turn it off if it looks wrong
BORDERLESS FULLSCREEN ON fills your screen; F11 does the same
SCREEN LAYOUT MERGED the one widescreen picture, or the two DS screens laid out as on other emulators

Desktop shortcuts: DESKTOP SHORTCUTS on the settings page puts a shortcut for each game on your desktop (on Linux also in your apps menu, and so in the Steam Deck's "Add a Non-Steam Game" list), with its box art; each starts its game straight away.

Steam Deck direct launches: In Desktop Mode, use FullDex Settings > DESKTOP SHORTCUTS, then open Steam > Add a Game > Add a Non-Steam Game and select the generated game entries. They appear in Gaming Mode under Non-Steam and start the selected ROM directly, including hacks. Recreate shortcuts after moving a ROM. The desktop icon is included; Steam library cover artwork can be assigned separately in Steam. New Deck setups use Start for the pause menu; saved START BUTTON choices are respected.

What it needs: Windows 10 or 11 (64-bit), or 64-bit Linux from late 2023 on (Ubuntu 24.04, Fedora 39, SteamOS 3.5 or newer); nothing else to install. For WORLD ON GPU, a graphics card with OpenGL 4.3, which nearly any from 2012 on has with up-to-date drivers; without it, the processor draws the world (that wants a much faster processor).

Steam Deck: in Desktop Mode, unpack the Linux download and put your ROMs in its roms folder; in Steam, Games > Add a Non-Steam Game to My Library, browse to pokemon-ds-wide (file type: All Files); then start it from your library in Gaming Mode with a gamepad controller layout. Set 3D RESOLUTION to 720P for the Deck's 1280x800 screen.

Mac (macOS 11 or newer):

  1. Download the one for your Mac. Apple menu > About This Mac: if it says Chip: Apple M1 (or M2, M3, M4, ...), take pokemon-ds-wide-pc-macos-arm64.zip; if it says Processor: Intel, take pokemon-ds-wide-pc-macos-x86_64.zip.
  2. Unzip it (double-click it in Downloads; Safari may have done it already) and drag Pokémon Fulldex into Applications.
  3. Open it once. macOS says it can't check the app (it isn't notarised by Apple): click Done. Then go to System Settings > Privacy & Security, scroll down to the line about Pokémon Fulldex and click Open Anyway, then Open. You only do this once. Or, in Terminal: xattr -dr com.apple.quarantine "/Applications/Pokemon Fulldex.app", then open it as any app.
  4. Add your ROMs: press O in the game list. The Finder opens its roms folder (~/Library/Application Support/Pokemon DS Widescreen/roms): put your DS and GBA ROMs in it and they appear in the list. Your own saves go in the saves folder next to it.

The keys and a controller work as on a PC; Ctrl+Cmd+F (or F11) switches between fullscreen and a window. A Mac's OpenGL stops short of what WORLD ON GPU needs, so the processor draws the widescreen world, at 720P to start: a MacBook Air M1 holds 60 FPS at 1080P.

How fast a PC? Not measured on a range of PCs yet, so these are estimates. The Switch runs all seven games at 60 fps, and one core of any PC from the last eight years or so is several times as fast as one of the Switch's. What grows with your screen is the 3D resolution, drawn by the graphics card:

  • Minimum: a 4-core processor (Intel Core i5 6th generation or Ryzen 1000 on), graphics built into the processor (Intel HD 520 or Radeon Vega 8 class) at 720p to 1080p, 4 GB of memory.
  • Recommended: a recent 6-core processor and a graphics card such as a GTX 1060 or RX 580 for 1440p; 4K wants an RTX 2070 or better.

Tell us how yours runs, with its game.log.

On the Nintendo Switch

Show the guide

The Switch game list: the DS games, the GBA games and Omega Ruby (COMING SOON) under their headings, with tabs for each console

All seven games in one program (pokemon-ds-wide-all-switch.zip):

  1. Unzip it to the root of the SD card. It makes /switch/pokemon-ds-wide/ with an empty roms folder inside.
  2. Copy your ROMs into /switch/pokemon-ds-wide/roms/ (any names).
  3. Hold R while starting any game, pick Pokémon Fulldex, then the game (started from the album there is not enough memory).

In the list the D-pad or a stick moves between games, A plays, Y opens the settings (the pause menu's options, each explained) and + goes back to the Homebrew Menu. It opens on the game you played last. While playing, + opens the pause menu (START BUTTON in the settings can make + the DS's START again, with + and − together for the menu); QUIT there saves and comes back to the list (also when started from its HOME Menu icon). With only one game found there is no list: it starts straight away. Touch screen: tap it in handheld mode; docked, the right stick moves a cursor and ZL touches. Pressing the right stick in shows the other screen.

Coming from the older one-game downloads? Their folders keep working: the list also shows the games in them (/switch/pokemon-black2-wide/ and so on) and plays each with the save already there. Those downloads are no longer updated, so the all-in-one is the one to use.

Saves: each game keeps its save under its own name (black2.sav, white2.sav, black.sav, white.sav, soulsilver.sav, heartgold.sav, platinum.sav), with the GBA games' (emerald.sav...): in the saves folder of /switch/pokemon-ds-wide/ for a ROM in its roms folder, or of an older one-game download's folder for a ROM there. Saves an earlier version left beside the ROMs are moved into saves the first time the list opens (that older download no longer finds them). To carry on from an emulator or a flash cart, copy your save in under that name.

Pictures: each game shows its box art. For your own, put a square JPEG or PNG in /switch/pokemon-ds-wide/icons/ named after the game's code: IRBO Black, IRAO White, IREO Black 2, IRDO White 2, IPKE HeartGold, IPGE SoulSilver, CPUE Platinum (e.g. icons/IREO.jpg).

Recommended: start each game from the HOME Menu. In the all-in-one's settings (Y in the list), HOME MENU ICONS puts an icon for each game in the list on the Switch's HOME Menu, with its box art, which starts that game straight away with no holding R. It is made on your console (no PC or keys file). Like any forwarder, the icons need sigpatches to start. Keep /switch/pokemon-ds-wide/ where it is, as the icons start the program in it; choose HOME MENU ICONS again after adding games. Each game then has its own entry, so sys-clk (below) can have its own settings for it. To remove one: Options on its icon, Data Management, Delete Software.

sys-clk (recommended for full speed), handheld. With a forwarder, start the game, open sys-clk's overlay and set these for that game's own profile: they then apply whenever you play it, and only then. Without one, set them for the game you start the Homebrew Menu from, or as the global profile.

CPU 1785 MHz (1581 is enough for most places)
GPU 460 MHz (the highest of the console's own handheld speeds; no need to go higher)
Memory 1600 MHz

Without sys-clk the games run at the console's normal speeds and drop frames in busy places.

Settings (all of them: Settings). Recommended on the Switch:

Setting Recommended What it does
60 FPS ON in-between frames: the games draw their 3D at 30 fps
BATTLE BUTTONS PANEL Black 2, White 2, Black and White: the game's own FIGHT, BAG, RUN and POKÉMON panel beside the battle (Black and White also have STRIP: large buttons in the message box)
WORLD DETAIL 720 lines the wide world is drawn with (540 if you want headroom)
LOWER DETAIL WHEN BUSY OFF ON: fewer lines for a moment instead of slowing down

The world is always drawn by the Switch's graphics chip, and each frame is shown at an even time, a frame after it is made (smoother in busy towns and battles). The games run on melonDS's FAST JIT. If a start ever fails with it, the next one falls back by itself (hold L while starting for the interpreter).

On Android

Show the guide
  1. Download pokemon-ds-wide-android.apk on your phone and open it. Android asks to allow installing apps from your browser or Files app the first time: allow it, then install.
  2. Put your ROMs in a folder on the phone (any names), for example ROMs in its internal storage.
  3. Start Pokemon DS, tap the screen, allow access to files, and pick that folder. Tap a game twice (or press A on a controller) to play.

Controls: on-screen buttons (D-pad, A, B, X, Y, L, R, START, SELECT and MENU at the top) while you play by touch; hold >> beside R to fast forward; tap the picture itself to touch the DS's touch screen. A controller (Bluetooth or USB: Xbox, PlayStation, Backbone, Razer Kishi and others) plays as a DS and hides the on-screen buttons; its Start opens the pause menu and its right trigger fast forwards. CONTROLS > KEYS AND BUTTONS in the pause menu (and on the game list) changes which button does what, including fast forward, swapping the screens, save state and load state.

Saves go in a saves folder inside your ROMs folder (made for you). The settings and game.log are in Android/data/io.github.mamesj.pokemonds/files.

What it needs: Android 7.0 or newer on a 64-bit phone. The 3D world is drawn by the processor at 720P to start (3D RESOLUTION in the settings: Y in the list, or SETTINGS at the top right). Tested on a Pixel 9 Pro XL, where it runs at full speed; please tell us how yours runs (see Reporting a bug).

Android also has a layout editor in the pause menu for moving and resizing the on-screen buttons.

On an iPhone or iPad

Show the guide

Apple only lets apps from its App Store install on their own, so this one is sideloaded: a sideloading tool signs it with your own Apple ID (a free one works) and puts it on your iPhone. From a Windows PC or a Mac:

  1. Install a sideloading tool: Sideloadly or AltStore (on Windows, also Apple's Apple Devices app or iTunes).
  2. Download pokemon-ds-wide-ios.ipa, plug in your iPhone (tap Trust on it), and give the IPA to the tool with your Apple ID.
  3. On the iPhone: turn on Settings > Privacy & Security > Developer Mode (it restarts), then trust your Apple ID in Settings > General > VPN & Device Management.
  4. Put your ROMs in the Files app: On My iPhone > Pokémon Fulldex > roms (AirDrop, iCloud Drive, or from a PC: the Apple Devices app's Files tab, or the Finder on a Mac). DS and GBA ROMs go in that same roms folder. A .gba opened from the Files app is taken in too. FOLDER at the top of the game list opens that folder. Tap a game twice to play.

With a free Apple ID, iOS stops opening sideloaded apps after 7 days: sideload it again (your saves stay). AltStore and SideStore can do that for you.

Controls: as on Android: on-screen buttons while you play by touch (MENU at the top for the pause menu), or a controller (Xbox, PlayStation, Backbone and others), which hides them. The game list is upright. Starting a game turns an iPhone or an iPad sideways.

Saves, settings, cheats and game.log are all in that Pokémon Fulldex folder in the Files app.

What to expect: iOS lets no app make code as it runs, so the faster way the other versions run the DS (melonDS's JIT) is left out, and a recent iPhone (an iPhone 13 or newer) is the most likely to keep up. The 3D world is drawn by the processor at 720P to start (3D RESOLUTION in the settings; 540P or LOWER RES WHEN BUSY if yours slows down). QUIT in the pause menu may close the app rather than go back to the list (open it again to pick a game). Please tell us how it runs on yours, with your model (see Reporting a bug).

Omega Ruby and Alpha Sapphire (3DS, beta)

Played natively from your own game dump (a .3ds file; none is included), with widescreen or one screen, sharp 3D up to 4K, fast forward and the FullDex menus. They are in the 3DS Beta tab. The game's code is built once from your dump for the best speed; until then it can still play.

It is a beta: back up your saves, and please report anything that goes wrong.

Features

Settings

The same on every platform: on the game list's settings page (H, or Y / △ on a controller, or SETTINGS at the top), or in the pause menu while you play (Esc, or START / Options / +). Each option is explained on the settings page.

Group Settings
DISPLAY LANGUAGE, SCREEN LAYOUT (MERGED: the one widescreen picture), LARGE SCREEN, BORDERLESS FULLSCREEN, SMOOTH SCALING, DS SCREEN FILTER (OFF / SCANLINES / LCD GRID), GBA LCD EFFECT, BATTLE BUTTONS, FPS COUNTER
SOUND VOLUME (a slider: OFF, then 10% to 100%)
GRAPHICS 60 FPS, WIDESCREEN WORLD, WIDE MAP LOADING, 3D RESOLUTION (WORLD DETAIL on the Switch), LOWER RES WHEN BUSY, WORLD ON GPU, FAST FORWARD LOW RES
CONTROLS KEYS AND BUTTONS (give any DS button, the pause menu, fast forward, swapping the screens, save state or load state another key or controller button), START BUTTON, BUTTONS, STICK TOUCH CURSOR
SHORTCUTS DESKTOP SHORTCUTS (PC), HOME MENU ICONS (Switch): a shortcut for each game

The pause menu also has RESUME, SAVE STATE, LOAD STATE, FAST FORWARD, CHEATS (below), RETROACHIEVEMENTS (below), RESET GAME and QUIT (back to the game list). LOAD STATE takes you back to where the state was made but leaves your in-game save as it is; saving in the game afterwards writes over it as usual. Not every platform has every setting: a phone and the Switch are always full screen, for one.

RetroAchievements

Earn RetroAchievements as you play, on every platform: in the pause menu, RETROACHIEVEMENTS, turn it ON and LOG IN with your RetroAchievements account (a free one from their website). Your password goes to RetroAchievements once and is not kept: the program keeps only the sign-in they send back. Unlocks pop up as you play. On a PC, a phone, a Mac or an iPhone you can also do this before playing, in the game list's SETTINGS > RETROACHIEVEMENTS.

Use your own save

Carry on from your own save: from another emulator, a flash cart or your real cartridge. Copy it in under the game's name, in this folder:

Where you play Folder
PC (Windows, Linux, Steam Deck) the saves folder beside the program
Linux AppImage ~/.local/share/pokemon-ds-wide/saves
Mac ~/Library/Application Support/Pokemon DS Widescreen/saves
Android the saves folder inside the folder you chose for your ROMs
iPhone and iPad Files app: On My iPhone (or iPad) > Pokémon Fulldex > saves
Nintendo Switch /switch/pokemon-ds-wide/saves/ on the SD card
Game Save name
Black 2 / White 2 black2.sav / white2.sav
Black / White black.sav / white.sav
SoulSilver / HeartGold soulsilver.sav / heartgold.sav
Platinum platinum.sav
Diamond / Pearl diamond.sav / pearl.sav
GBA games emerald.sav, ruby.sav, sapphire.sav ...

Other languages add theirs to the name (heartgold-it.sav, black2-es.sav ...).

Updates

The game list checks for updates when it opens: choose INSTALL or LATER (CHECK FOR UPDATES in SETTINGS > HELP any time). Downloads are checked against the release's SHA256SUMS.txt before anything is replaced, and the previous program is kept; your ROMs, saves and settings stay where they are. Android uses its own installer; on a Mac, iPhone or iPad it opens the download page.

Using an existing ROM library

On PC and Android, open ROMs → Choose ROMs Folder in the launcher. Choose the folder where you already keep your games, including a library shared with another emulator. Fulldex scans its subfolders too. The games stay where they are, and changing the ROM folder does not move your saves. On Android, allow file access when the system asks.

Cheats

Action Replay codes, turned on and off as you play: CHEATS in the pause menu. They go in a cheats folder (make it if it isn't there):

Where you play Folder
PC (Windows, Linux, Steam Deck) cheats beside the program (next to saves)
Linux AppImage ~/.local/share/pokemon-ds-wide/cheats
Mac ~/Library/Application Support/Pokemon DS Widescreen/cheats
Android cheats inside the folder you chose for your ROMs
iPhone and iPad Files app: On My iPhone (or iPad) > Pokémon Fulldex > cheats
Nintendo Switch /switch/pokemon-ds-wide/cheats/ on the SD card

The codes must be for your version of the game (US or Europe). A cheat changes the game's memory while it runs: save first, and turn it off if the game misbehaves.

CHEATS also has SEARCH (names, folders and descriptions): type on the keyboard, or use the letter chooser with a controller or touch.

The game list's look

SETTINGS > GAME LIST in the game list:


The games

Pokémon Black 2 and White 2

Black 2: Black Kyurem against a wild Crustle, with the game's FIGHT, BAG, RUN and POKÉMON panel beside the battle White 2: White Kyurem against a wild Tropius, with the FIGHT panel beside the battle
Black 2: the view from Aspertia's lookout, sky and mountains carried to the edges Black 2: Castelia City's pier

Pokémon SoulSilver and HeartGold

SoulSilver: a wild Meowth appears and Lugia is sent out, in widescreen

HeartGold: Totodile against a wild Pidgey on Route 29, with FIGHT, BAG, RUN, POKÉMON and the party beside the battle SoulSilver: Lugia following you along Route 7

Pokémon Black and White

Black: Reshiram against a wild Mantyke, with the game's FIGHT, BAG, RUN and POKÉMON panel beside the battle White: Zekrom in battle, with the FIGHT panel beside it
Black: a double battle, Reshiram and Excadrill against a wild Pelipper and Mantyke, the HP boxes down the edges Black: Nimbasa City in widescreen

Pokémon Platinum

Platinum: Infernape against a wild Machoke, with FIGHT, BAG, RUN and POKÉMON beside the battle Platinum: Snowpoint City in the snow, in widescreen

Pokémon Diamond and Pearl

Diamond: Giratina against Elite Four Aaron's Dustox, with its moves beside the battle Diamond: the Pokémon League, in widescreen

The GBA games

Emerald: a wild Rayquaza appears at the top of Sky Pillar and Salamence is sent out, in widescreen

Emerald: walking across Pacifidlog Town's log bridges, the sea reaching both edges Emerald: Sootopolis City, inside the crater
Ruby: Blaziken against Groudon in the Cave of Origin, the harsh sunlight across the whole width Sapphire: Swampert against Kyogre in the Cave of Origin
Ruby: Groudon wakes in its pool of magma at the bottom of the Cave of Origin Ruby: Lilycove City, the Department Store at the top
FireRed: Charizard's Flamethrower at Mewtwo in Cerulean Cave FireRed: Charizard against the Snorlax on Route 16
LeafGreen: Venusaur's Razor Leaf at Articuno in the Seafoam Islands LeafGreen: Lavender Town, with Pokémon Tower at the top

Pokémon Emerald, Ruby, Sapphire, FireRed, LeafGreen and Ultra Violet (a FireRed hack) in widescreen at 60 fps, from Pokémon GBA Widescreen, built in on Windows, Linux, Mac, Android, iPhone, iPad and the Switch.


Under the hood

The widescreen world is drawn by a graphics chip: your graphics card with OpenGL on a PC, the Switch's own with deko3D. On the Switch, Black 2 runs at (or a whisker under) 60 fps at 720p in towns and battles, measured on a Switch OLED in handheld mode; a PC has room to spare, and draws the same picture up to 4K. The full list of changes is in CHANGELOG.md.

Known limits

What's next

Reporting a bug

Open a bug report (you need to be signed in to GitHub). The form asks for the game, your ROM's version and the game.log file, which says what the program did:

  1. Find it: on a PC, game.log is in the folder you unpacked the download to. On the Switch it is in the game's folder on the SD card: /switch/pokemon-ds-wide/ for the all-in-one, otherwise the game's own folder (e.g. /switch/pokemon-black2-wide/). On an iPhone or iPad it is in the Files app: On My iPhone > Pokémon Fulldex (share it from there). It is written again each time the game starts, so copy it straight after the problem.
  2. Switch: get it onto a computer. Put the SD card in a card reader; or, leaving it in the Switch, use Hekate's Tools > USB Tools > SD Card (or DBI's MTP mode) to see the card on the computer over USB; or an FTP app such as ftpd over Wi-Fi.
  3. Add it to the form: drag the file into the game.log box.

A screenshot or short video helps too. Please never attach your ROM. A white or A white or black screen when a game starts usually means the ROM isn't one in Supported games, or has been changed (patches, translations, randomizers or trimming).

Support

Tips are welcome but never expected: buy me a coffee or PayPal.

Credits and licence

A fork of ClickingMaster/ssrecomp (Pokémon SoulSilver recompiled for single-screen devices), which gave this its single-screen and widescreen view; its README covers that project. Function names come from the pokebw2 and aletheia decompilations (only their symbol files), Platinum's from a build of pret/pokeplatinum; SoulSilver's and HeartGold's addresses come from ssrecomp's own SoulSilver layout. The DS is emulated by melonDS. The built-in DS cheats come from DeadSkullzJr's cheat database, as carried in libretro-database. The Switch's HOME MENU ICONS are made the way sphaira makes its forwarders, with its homebrew loader (tools/switch/forwarder, GPL-3.0, based on nx-hbloader). The GBA games are played by Pokémon GBA Widescreen, built on mGBA (MPL-2.0: LICENSE-mGBA.txt in the downloads that have the GBA games).

GPL-3.0-or-later (see LICENSE), as required by melonDS. Not affiliated with or endorsed by Nintendo, Game Freak, The Pokémon Company or the melonDS project; Pokémon is a trademark of its owners. The box art in the PC game list belongs to Nintendo, Creatures, GAME FREAK and The Pokémon Company and is shown only to tell the games apart; it is not part of this repository's code. If you hold the rights and want it removed, open an issue and it will be taken out.


Built with AI assistance.

Custom touch controls and regional profiles

Android players can move and resize on-screen controls in the paused layout editor. The launcher and Fulldex menus offer AUTO, English, Spanish, Italian, French, German, Japanese and Korean interface languages. Embedded GBA menus follow the launcher language too. See controls, regional games and build notes.

Companion additions: Based on PokeDaisy by Lidor Itzhari - https://github.com/lidor30/pokedaisy

Open a DS game from an Android frontend

A frontend or file manager can send an Android VIEW intent for an .nds ROM to FullDex. A readable file opens directly. Document-provider links are copied into FullDex storage before launch, so they also work when the provider exposes no ordinary file path; the original file is unchanged. Existing save-folder settings and save checks are retained. While FullDex is already showing its library, a new link starts the selected game. Quit an active game before opening another link. This integration still needs testing with individual frontends and devices.

Android folders without ordinary file access

Granting all-files access lets FullDex use a shared ROM folder directly. If that permission is declined, or a document provider exposes no filesystem path, choosing a folder imports its .nds and .gba files into FullDex storage instead. The app shows when it is importing and how many ROMs were found. Nested folders are supported; choose a smaller folder if a traversal/size limit is reached. Original files remain untouched. These are separate ROM copies: changes made by another emulator are not automatically synchronised, and source saves are not imported automatically. Existing FullDex save locations are retained and must remain accessible. This fallback needs testing on affected GrapheneOS devices.

ROM imports reuse identical files and refuse to overwrite a different ROM with the same filename. Rename the incoming ROM or choose its existing ROM folder instead. An explicitly imported save still gets a safety backup before replacement.

pokemon-fulldex (mamesj/pokemon-fulldex)

正在搜索数据库…

这是什么?Pokemon Fulldex 是一个宽屏、60fps 的播放器,可运行全部七款 DS Pokemon 游戏(Black 2、White 2、Black、White、SoulSilver、HeartGold、Platinum)以及四款 GBA 游戏,支持 PC、Mac、Steam Deck、Android、iPhone 和改装过的 Switch。你需要自备 ROM;程序会把两块小小的 DS 屏幕合并成一个大的 16:9 画面。
这是原生移植版,还是只是画面更好看的模拟器?它不是原生移植版。它在内置的 melonDS 内核(GBA 游戏则使用 mGBA 内核)中运行真正的 DS/GBA 游戏,并通过一个额外的处理层,把双屏的 DS 画面重新排版成一个宽屏画面,最高可达 4K,而不是上下堆叠的两块 256x192 屏幕。
我该怎么让它运行起来?从 Releases 页面下载适合你平台的版本(zip、tar.gz、AppImage、APK、IPA 或 Switch zip),解压后把你的 ROM 放进其中的 roms 文件夹,然后启动程序,从列表中选择一款游戏。
我需要安装 melonDS,或从别处获取 ROM 吗?不需要单独安装模拟器,因为 melonDS/mGBA 已内置。但下载包不包含游戏,你必须自备 ROM 文件,程序会在游戏启动时读取这些文件。
开启存档状态和作弊功能时,RetroAchievements 还能正常工作吗?成就只在休闲模式下记录(存档状态、快进和作弊仍可使用)。只要启用了作弊或“Other Version Pokemon”,成就就会自动暂停,关闭后恢复记录。
我的 RetroAchievements 密码会被保存在什么地方吗?不会。你的密码只会在登录时发送一次给 RetroAchievements,并且不会被保留;本应用只保存它返回的登录令牌。
我能继续使用来自烧录卡或其他模拟器的存档吗?可以。来自 melonDS、DeSmuME 导出、烧录卡(TWiLight Menu++、R4)以及卡带转储工具(Checkpoint、JKSM、GodMode9)的普通 .sav 存档都可直接使用;DraStic/DeSmuME 的 .dsv 和 Action Replay 的 .duc 存档则需要先用随附的 convertsave.py 脚本转换。
游戏时能使用 Action Replay 作弊码吗?可以,通过暂停菜单中的 CHEATS 选项即可。你可以放入社区提供的 usrcheat.dat 数据库(适用于所有游戏),也可以为每款游戏自行编写一个文本格式的作弊码文件,游戏中可随时开启或关闭。
它实际包含哪些 Pokemon 游戏?同一个程序包含全部七款 DS 游戏(Black 2、White 2、Black、White、SoulSilver、HeartGold、Platinum),以及 GBA 游戏 Emerald、FireRed、LeafGreen 和 Ultra Violet,后者在 Windows、Linux、Android 和 Switch 上可用;Pokemon Omega Ruby 是另一个正在开发中的独立项目。
和直接在 melonDS 里运行相比,画面清晰多少?它不再显示两块被压扁的 DS 屏幕,而是以 60fps 绘制合并后的 16:9 画面,在 PC 上可放大到最高 4K(在 Switch 上为 720p)。
作者
mamesj
大小
74.3 MB
星标
1.2K
时长
24天
提交 · 90 天