Guac Emulatorhttp://guacemulator.com/Recent content on Guac EmulatorHugoenMIT License<link>http://guacemulator.com/docs/configuration/cli/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/configuration/cli/</guid><description><h1 id="command-line">Command Line<a class="anchor" href="#command-line">#</a></h1> <p>The command line acts as an configuration override for some important settings.</p> <h2 id="rom-path--r">Rom Path (-r=&quot;&hellip;&quot;)<a class="anchor" href="#rom-path--r">#</a></h2> <p>Rom Path (-r) will override the configuration file and immediately load a rom without using the gui to choose a file. This should be a string value of a valid path.</p> <h2 id="target-fps--fps">Target Fps (-fps=&hellip;)<a class="anchor" href="#target-fps--fps">#</a></h2> <p>Target Fps (-fps) will override the configuration file and attempt to run the emulator at the provided fps. This should be a valid positive integer.</p></description></item><item><title/><link>http://guacemulator.com/docs/configuration/colors/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/configuration/colors/</guid><description><h1 id="colors">Colors<a class="anchor" href="#colors">#</a></h1> <p>Color inputs are provided as a hexadecimal string in the format &ldquo;RRGGBB&rdquo;. The max value for each channel is FF, and the minimum is 00.</p></description></item><item><title/><link>http://guacemulator.com/docs/configuration/controller/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/configuration/controller/</guid><description><h1 id="controller">Controller<a class="anchor" href="#controller">#</a></h1> <p>Controller and Gamepad input uses the <a href="https://www.w3.org/TR/gamepad/#remapping">web standard canonical layout</a>. Axis input is not supported at this time. The following values are valid:</p> <pre><code>RightBottom RightRight RightLeft RightTop FrontTopLeft FrontTopRight FrontBottomLeft FrontBottomRight CenterLeft CenterRight LeftStick RightStick LeftTop LeftBottom LeftLeft LeftRight CenterCenter </code></pre> <p>The config file uses these quoted values in a comma separated list. The settings ui uses these value, not quoted, in a comma separated line.</p></description></item><item><title/><link>http://guacemulator.com/docs/configuration/keys/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/configuration/keys/</guid><description><h1 id="keys">Keys<a class="anchor" href="#keys">#</a></h1> <p>Keyboard input uses a Custom list of key names, which matches <a href="https://ebitengine.org/">Ebitenengine</a>. Mouse input configuration is not supported at this time. The following values are valid:</p> <pre><code>A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Alt AltLeft AltRight ArrowDown ArrowLeft ArrowRight ArrowUp Backquote Backslash Backspace BracketLeft BracketRight CapsLock Comma ContextMenu Control ControlLeft ControlRight Delete Digit0 Digit1 Digit2 Digit3 Digit4 Digit5 Digit6 Digit7 Digit8 Digit9 End Enter Equal Escape F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 Home Insert IntlBackslash Meta MetaLeft MetaRight Minus NumLock Numpad0 Numpad1 Numpad2 Numpad3 Numpad4 Numpad5 Numpad6 Numpad7 Numpad8 Numpad9 NumpadAdd NumpadDecimal NumpadDivide NumpadEnter NumpadEqual NumpadMultiply NumpadSubtract PageDown PageUp Pause Period PrintScreen Quote ScrollLock Semicolon Shift ShiftLeft ShiftRight Slash Space Tab </code></pre> <p>The config file uses these quoted values in a comma separated list. The settings ui uses these value, not quoted, in a comma separated line.</p></description></item><item><title/><link>http://guacemulator.com/docs/getting-started/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/getting-started/</guid><description><h1 id="getting-started">Getting Started<a class="anchor" href="#getting-started">#</a></h1> <h2 id="installation">Installation<a class="anchor" href="#installation">#</a></h2> <p>The latest release is available as pre-compiled binaries on <a href="https://github.com/aabalke/guac/releases">github</a>. Binaries are available for Windows x86/ARM, Linux x86/ARM, and Mac ARM.</p> <h2 id="building">Building<a class="anchor" href="#building">#</a></h2> <p>Building from source is possible with go version &gt;= 1.26, using:</p> <pre tabindex="0"><code>go build .</code></pre><h3 id="debian--ubuntu--raspberry-pi">Debian / Ubuntu / Raspberry Pi<a class="anchor" href="#debian--ubuntu--raspberry-pi">#</a></h3> <p>For building on Debian systems the following packages must be installed:</p> <pre tabindex="0"><code>sudo apt install libx11-dev libxrandr-dev libxcursor-dev libxinerama-dev libxi-dev libasound2-plugins libgtk-3-dev pkg-config</code></pre><p>On Ubuntu these packages should come installed; however, on Raspberry Pi OS these packages will not come pre-installed.</p></description></item><item><title/><link>http://guacemulator.com/docs/features/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/features/</guid><description><h1 id="features">Features<a class="anchor" href="#features">#</a></h1> <h2 id="emulation-out-of-the-box">Emulation out of the box<a class="anchor" href="#emulation-out-of-the-box">#</a></h2> <p>guac does not require any bios or firmware files (but you can provide!), just the roms you are interested in using. It also has full controller support even in menus, with on screen keyboards.</p> <h2 id="jit-compiler">Jit Compiler<a class="anchor" href="#jit-compiler">#</a></h2> <p>Nintendo DS emulation on guac comes with a one-of-a-kind jit compiler. This allows cpu emulation to be 2-5x faster depending on workloads. This is the first jit compiler that can interop with (more like confuse) the golang runtime to allow calls to go functions from jit code. Additionally, this is the first arm64 jit compiler written in golang. For more information please see <a href="https://github.com/aabalke/gojit/">aabalke/gojit</a>.</p></description></item><item><title/><link>http://guacemulator.com/docs/files/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>http://guacemulator.com/docs/files/</guid><description><h1 id="files">Files<a class="anchor" href="#files">#</a></h1> <h2 id="roms">Roms<a class="anchor" href="#roms">#</a></h2> <p>All roms must have proper extensions. Only the extensions gb, gbc, gba, and nds are supported.</p> <h2 id="saves">Saves<a class="anchor" href="#saves">#</a></h2> <p>Save files are generated or overwritten at runtime, they will always be in the same directory as rom, with the same file path except with an additional &ldquo;.save&rdquo; at the time. The rom &ldquo;./mario.nds&rdquo;, will have the save &ldquo;./mario.nds.save&rdquo;.</p> <h2 id="bios--firmware">Bios / Firmware<a class="anchor" href="#bios--firmware">#</a></h2> <p>Bios and firmware files are not required. The emulator uses Drastic open source alternatives bios files. If you do want to include bios and firmware files, add them through the config.toml or settings ui.</p></description></item></channel></rss>