mirror of https://github.com/gopher64/gopher64.git synced 2026-07-11 01:25:20 +02:00

T

Logan McNaughton 01a53ce1c0 use no-intro names in netplay/cheats (#1133 )

* use no-intro names in netplay/cheats

* more

* more

2026-06-29 19:37:33 +00:00

.cargo

cargo update (#1040 )

2026-06-08 14:28:51 +00:00

.github

Bump actions/checkout from 6 to 7 (#1108 )

2026-06-22 05:00:57 +00:00

android-project

update NDK (#981 )

2026-05-29 05:42:41 +00:00

data

use no-intro names in netplay/cheats (#1133 )

2026-06-29 19:37:33 +00:00

parallel-rdp

move netplay init (#1078 )

2026-06-14 20:36:54 +00:00

retroachievements

fix ra init on android (#963 )

2026-05-27 13:39:37 +00:00

src

use no-intro names in netplay/cheats (#1133 )

2026-06-29 19:37:33 +00:00

.gitignore

ignore settings.json

2025-05-16 13:32:54 +02:00

.gitmodules

RetroAchievements (#710 )

2026-04-07 08:59:03 +02:00

build.rs

use idle (#1039 )

2026-06-08 13:23:22 +00:00

Cargo.lock

use no-intro names in netplay/cheats (#1133 )

2026-06-29 19:37:33 +00:00

Cargo.toml

use no-intro names in netplay/cheats (#1133 )

2026-06-29 19:37:33 +00:00

LICENSE

Initial Commit

2023-10-04 14:33:17 -06:00

README.md

update contributing guidelines (#1130 )

2026-06-29 09:53:00 +00:00

rust-toolchain.toml

bump rust (#976 )

2026-05-28 18:09:08 +00:00

README.md

gopher64

Gopher64 is a cross-platform N64 emulator. Some notable features:

Netplay
Homebrew support
Upscaling
CRT shader
Emulate CPU overclocking
Cheats
Savestates
RetroAchievements

download

Windows:

Standalone executable: gopher64-windows-x86_64.exe

MacOS:

App Bundle: gopher64-macos-aarch64.zip
Homebrew: brew install --cask gopher64

Linux:

Standalone executable: gopher64-linux-x86_64
Flatpak: flatpak install flathub io.github.gopher64.gopher64

Android:

APK: gopher64-android.apk

wiki

https://github.com/gopher64/gopher64/wiki

discord

Discord invite link

controls

Keys are mapped according to these defaults. Xbox-style controllers also have a default mapping applied.

netplay

Gopher64 supports P2P netplay (online play with others).

Please read the guide before trying out netplay.

portable mode

If you would like to keep all the game data in the same folder as the executable, you just need to create a file called "portable.txt" in the same directory as the executable.

flatpak

If you want to run the flatpak from the command line, you need to add the --filesystem=host:ro option, for example:

flatpak run --filesystem=host:ro io.github.gopher64.gopher64 /path/to/rom.z64

building and usage

Linux only: install the SDL3 dependencies
Install rust
git clone --recursive https://github.com/gopher64/gopher64.git
cd gopher64
cargo build --release
./target/release/gopher64 /path/to/rom.z64

contributing

I would prefer that people did not submit PRs that are vibe coded and/or co-authored by AI agents. If you are going to submit a PR, and especially if you are going to submit a PR that is AI-assisted, it should be scoped to a single feature/improvement.

Please contact me via a GitHub issue or Discord (loganmc10) before doing substantial work on a PR.

license

Gopher64 is licensed under the GPLv3 license. Many portions of gopher64 have been adapted from mupen64plus and/or ares. The license for mupen64plus can be found here. The license for ares can be found here.

privacy and code signing policy

Free code signing for the Windows release is provided by SignPath.io, certificate by SignPath Foundation.

During online netplay sessions, the server logs your IP address and basic session information (game title and session name) for operational purposes. No additional personal data is collected or stored.

If you enable the RetroAchievements feature, some data is sent to their systems. Please see their terms here.

Languages

Rust 84.4%

Slint 6.5%

C++ 6.4%

C 1.9%

GLSL 0.5%

Other 0.2%