镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content
View ludufre's full-sized avatar

Block or report ludufre

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ludufre/README.md

👋 Hey there! I'm Luan Freitas

Senior Systems Consultant & Open Source Developer

Sixteen years building and automating systems — financial and commercial platforms by day, and by night the kind of tool I wish existed: firmware for a Super Nintendo flashcart, ports of DOS classics to the SNES, an original SNES game, romhacks that put Super Scope games on the SNES Mouse, a translation of the Satellaview BS-X BIOS into eight languages, Ionic/Capacitor plugins and Angular libraries that other developers install. Portfolio at ludufre.com.

🇧🇷 Versão em Português

github-snake

🏹 New: QUIVER, my own SNES game

The QUIVER logo in gold, the four archers and the Monastery Bell arena

An original archer battle for the Super Nintendo. Three arrows each, one hit takes you out, the screen wraps around, and the last archer standing wins the round:

  • 🎮 1 to 5 players on one console, with Super Multitap support and CPU archers in three levels
  • ⚔️ Three modes: BATTLE, EXTRA with lives and CHALLENGE, co-op against monster waves
  • 🏰 Eight arenas, three of them built for wall jumps, plus power-ups and monsters

Under the hood: code, art, music, sound effects and text all made for this project, with the art drawn by code and the music written in MML for the Terrific Audio Driver. The ROM is free.

🌐 How to play, videos & free ROM

🕹️ New: SNES Ports

Dangerous Dave & Supaplex — SNES ports by ludufre

Two DOS classics, ported to the Super Nintendo:

  • 🧱 Dangerous Dave (1990) — John Romero's platformer, rebuilt straight from the original DAVE.EXE: the game logic translated function by function into C, VGA graphics in Mode 3 with 256 colors (sprites split into exact-palette layers) and the PC speaker emulated on the SPC700. 1 MB HiROM.
  • 🔴 Supaplex (1991) — the OpenSupaplex C reimplementation on an SA-1 cartridge: the 10.74 MHz coprocessor runs the whole game while the PC screen and the level live in battery-backed RAM, with hardware scrolling, an HDMA panel, battery saves and the original demos checked against the PC. Runs on a real SNES. Source code (GPLv3).

🌐 Gameplay, tech notes & free ROMs

🎯 New: SNES Romhacks & Translations

Super Scope games played with the SNES Mouse and the BS-X BIOS translated — romhacks by ludufre

The Super Scope light gun only works on CRT TVs. These BPS patches swap it for the SNES Mouse in six games, with an on-screen crosshair that sits exactly where the shot lands — so they play on any TV, emulator or flash cart:

  • 🦖 Yoshi's Safari
  • 🤖 Battle Clash, Metal Combat: Falcon's Revenge, Super Scope 6, X-Zone and Bazooka Blitzkrieg

Under the hood: 65816 hooks that replace each game's Scope reading, a crosshair sprite that takes its colors from the scene's own palettes and claims a free tile in VRAM, and the Scope's turbo emulated the way each game expects. Patches only — no ROMs.

🛰️ BS-X (Satellaview) in eight languages: the 1995 Satellaview BIOS — BS-X: The Town Whose Name Was Stolen, Japanese-only — now in Portuguese (Brazil), Spanish, German, French, Italian, Dutch, Russian and Simplified Chinese, built on LuigiBlood's English translation. Text tooling with pointer relocation, an LZ recompressor for the redrawn title, St.GIGA and reception screens, and the game's 12-px font extended with accents, a hand-drawn half-width Cyrillic set and the Chinese characters missing from Shift-JIS.

🌐 Patches, controls & downloads

🚀 Featured Open Source Projects

🎮 sd2snes+ — Enhanced sd2snes / FXPAK Firmware

sd2snes+

A feature-rich fork of the sd2snes / FXPAK firmware: covers, translations, savestates, cheats, themes & more

A community fork (sd2snes+) of the sd2snes firmware — the popular SD-card cartridge for the Super Nintendo (SNES / Super Famicom). It installs as a drop-in release over the official firmware (version-matched, FURiOUS Save States included) and adds a whole layer of user-facing features on top of the original, without removing anything.

🆕 2.17 — a Game Boy Color core, a guided tour of the features on the first boot, six more kinds of cartridge from the community (Seta ST011/ST018, copy-protected bootlegs, Super 20 in 1, Gamars Puzzle, .sfrom), the menu in Dutch and file-type icons in the browser.

Key Features:

  • 🌎 Menu in 8 languages — Brazilian Portuguese, English, Spanish, German, French, Italian, Russian & Dutch, down to a one-line description for every setting (and a date format that follows the language)
  • 🖼️ Game box-art in the file browser + a pre-launch info card (cover, animated clip with sound or a static shot, and the game's metadata)
  • 💾 Savestates on special-chip games that never had them — DSP1/1b/2/3/4, Super FX, OBC1, S-DD1 and CX4, plus SA-1 on the FXPak Pro (Mk.III)
  • 🧭 A guided tour on the first boot — one card per feature, with a picture of what it changes and the setting right there; each update brings back only what is new
  • 🎮 In-game menu with tabs (L+R+Y+←) — cheats toggled live, savestate slots, battery-save status and the game's manuals, with the game frozen where it was; SELECT lists every shortcut, and they can work from controller 2 too
  • 📖 Read the game's manual, map or walkthrough on the TV (.man, up to 8 per game) — it remembers the page you stopped at
  • 🩹 IPS/BPS patches applied at boot (translations, hacks, fixes) — original ROM untouched, or write a ready-patched copy next to it
  • 🎵 Menu background music (.spc) and 4 navigation sound effects, built in the browser with the Sound Creator
  • 🎨 Console-side menu themes (logo, colors, background) with a web editor & ready-made gallery — the sd2snes+ theme ships as the factory default since 2.15
  • 🕹️ Game Boy Color, Master System, NES & Atari 2600 cores (experimental, Mk.III only) — drop a .gbc, .sms, .nes or .a26 on the card and it shows up in the list, sound included
  • 🔎 RAM trainer — find your own cheats on the console: search memory for a value, filter until one address is left, then freeze it or save it as a real cheat
  • 🧩 Cores written for this fork — SPC7110 (Far East of Eden Zero), Super FX 3 (DOOM 2025), Sufami Turbo minicarts and Nintendo's Campus Challenge '92 / PowerFest '94 tournament carts
  • 🤝 Community cartridge cores, on both boards — Seta ST011 and ST018 (with its ARM coprocessor written from scratch), copy-protected bootlegs from the untouched dump, Super 20 in 1, Gamars Puzzle and SNES Classic .sfrom files, by M2M (@sttng) and @terminator2k2
  • ⌨️ Cheats typed in on the console, with an on-screen keyboard that only offers the characters a Game Genie or Pro Action Replay code can use
  • 🩺 Memory test in the menu — walks the PSRAM and SRAM lines and names the failing chip by its silkscreen
  • ⚙️ Quality-of-life extras: BS-X 8M Memory Pack, missing chip-BIOS warnings, delete file/save, smart reset-to-menu
  • 🌐 Companion browser tools — Web Manager (auto-fetches covers, game info, manuals & cheats by CRC32) + community GamesDB
  • 🔗 Based on the upstream project by @mrehkopf

🔗 View Repository · 🌐 Website · 🗂️ Web Manager · ⬆️ Upstream Project


🗂️ sd2snes+ Web Manager

Fill your SNES card with box art, game info, cheats and manuals — from the browser

The companion tool for the sd2snes+ firmware. Point it at your SD card and it identifies every ROM by CRC32 against the GamesDB, then downloads and writes everything the console shows: box art, info cards with animated previews, cheats, manuals and themes. It runs entirely in the browser through the File System Access API — the ROMs never leave your machine, only the checksum does.

Key Features:

  • 🔍 Identifies SNES, Satellaview, Game Boy / Color / Super, NES, Master System, Atari 2600 and Sufami Turbo ROMs by CRC32
  • 🖼️ Box art encoded in the browser by the same Go encoder the native tool uses, compiled to WebAssembly — identical bytes
  • 📖 Manual editor that turns a PDF or a pile of images into .man, splitting two-page spreads automatically
  • 🎨 Theme gallery with rendered previews, plus firmware and chip-BIOS installation
  • 🗃️ Reads the firmware version off the card and reorganizes it for the layout that firmware reads (2.15's two-letter folders, 2.16's per-console namespaces)
  • 🔒 Nothing is uploaded, ever — Chrome/Edge on desktop, and Chrome on Android

🔗 View Repository · 🌐 Use it now · 🗃️ GamesDB


📺 GBS-Control — Thales Câmara Edition

Custom firmware for the GBS Control (Blue) & GBSC Pro video upscalers

GBS Control (Blue)    GBSC Pro

Custom firmware for the GBS Control (Blue) and GBSC Pro open-source video upscalers, built for the Thales Câmara YouTube channel. It adds a full Brazilian Portuguese localization, curated console presets, a channel-themed UI and quality-of-life fixes — all flashable straight from the browser.

Key Features:

  • 🌎 Full pt-BR translation across Web UI, OLED menu and on-screen display (OSD)
  • 🎨 Custom Web UI theme matching the channel's identity
  • 🕹️ Curated presets for popular retro consoles (NES, SNES, Mega Drive, PlayStation, Saturn, N64 and more)
  • 🌐 Browser-based web installer (WebSerial) plus Wi-Fi OTA updates
  • 🧩 Two editions: Edição Azul (Blue) and Edição Pro

🔗 View Repository · 🌐 Web Installer · ▶️ Thales Câmara — YouTube


🛡️ MS Family Safety API

Unofficial TypeScript client for the Microsoft Family Safety API

A TypeScript library and CLI for interacting with the Microsoft Family Safety API. Enables developers to programmatically manage screen time, app policies, device restrictions, and respond to extension requests — useful for home automation and custom parental control workflows.

Key Features:

  • 🕐 Screen time schedule management (per platform, per day)
  • 📱 App block/unblock control
  • 🖥️ Device platform lock/unlock
  • 🔔 Pending screen-time request approval/denial
  • 🤖 Polling mode for Home Assistant integrations
  • ⌨️ Full CLI with short alias mfs

🔗 View Repository · 📦 npm


👨‍👩‍👧‍👦 Google Family Link API

Unofficial TypeScript client for the Google Family Link API — focused on time control

A TypeScript library and CLI for interacting with the Google Family Link API. Enables developers to programmatically manage screen time, device locks, time bonuses, bedtime and school time schedules — useful for home automation and custom parental control workflows.

Key Features:

  • 🕐 Daily screen time tracking with per-app breakdown
  • 🔒 Device lock/unlock control
  • ➕ Time bonus management (add/cancel)
  • 🌙 Bedtime schedule control (enable, disable, set per day)
  • 🏫 School time restrictions (enable/disable)
  • 📅 Daily limit management (enable, disable, set minutes)
  • 👥 Multi-account support (authUser parameter)
  • ⌨️ Full CLI with short alias gfl

🔗 View Repository · 📦 npm


📹 Dahua P2P

Reach Dahua and Intelbras cameras through the Easy4ip cloud relay — no app, VPN or port forwarding

A TypeScript library and CLI that opens a P2P tunnel to Dahua and Intelbras (Mibo Smart) cameras using only the device serial, even behind 4G and carrier-grade NAT. Adds a reliable PTCP layer on top of the reverse-engineered protocol, so the stream survives the relay's lost and reordered datagrams.

Key Features:

  • 🔌 Tunnel any device port (RTSP 554, HTTP 80, 37777) as a stream or a local TCP port
  • 🧱 Reliable PTCP: contiguous ACKs, out-of-order buffering and duplicate dropping
  • 🎥 RTSP client with Digest auth and H.264/H.265 depacketized into Annex B
  • 📸 Photo mode: first keyframe, then TEARDOWN — the tunnel is reused between photos
  • 📊 Wire-level byte accounting (IPv4/UDP headers included) for metered links
  • 🪶 Pure Node.js, no native dependencies

🔗 View Repository · 📦 npm


📱 Capacitor Screenshot

Take screenshots of your app with ease

A simple yet powerful plugin that enables developers to capture screenshots programmatically in Ionic Capacitor apps. Supports both base64 output and direct file saving with customizable paths.

Key Features:

  • 📸 Capture screenshots as base64 or save directly to disk
  • 🎯 Simple API with TypeScript support
  • 💾 Flexible output options (memory or file system)

🔗 View Repository · 📦 npm


🔐 Capacitor App Attest

Apple App Attest integration for enhanced security

Brings Apple's App Attest framework to Ionic Capacitor, providing app integrity verification and secure backend communication. Essential for apps requiring high security standards.

Key Features:

  • 🛡️ App integrity verification using Apple's App Attest
  • 🔑 Key generation and attestation
  • 🎯 Backend validation support with examples
  • 📱 iOS-focused security enhancement

🔗 View Repository · 📦 npm


✨ Capacitor Lottie Splash Screen

Beautiful animated splash screens with Lottie

Transform your app's first impression with stunning Lottie animations as splash screens. Supports light/dark themes, auto-hide functionality, and complete programmatic control.

Key Features:

  • 🎨 Beautiful Lottie animations as splash screens
  • 🌙 Automatic light/dark theme support
  • ⚙️ Flexible configuration options
  • 🔄 Loop control and auto-hide functionality

🔗 View Repository · 📦 npm


📊 Capacitor Live Activities

iOS Live Activities & Dynamic Island integration

A comprehensive Ionic Capacitor plugin that brings iOS 16.2+ Live Activities and Dynamic Island functionality to your apps. Features a powerful JSON-based layout system for creating rich, interactive live activities with real-time data updates.

Key Features:

  • 📱 Native iOS Live Activities support (iOS 16.2+)
  • 🏝️ Dynamic Island integration
  • 🎛️ JSON-based flexible layout system
  • 🔔 Real-time activity updates
  • 🎨 Rich media support (SF Symbols, images)
  • ⏱️ Timer and progress tracking capabilities
  • 📦 Easy installation and setup

🔗 View Repository · 📦 npm


🤖 Capacitor Foundation Models

On-device AI with Apple's Foundation Models

A cutting-edge Capacitor plugin that brings Apple's on-device AI capabilities to your Ionic apps. Enables privacy-first AI interactions with structured output support and complete device-level processing.

Key Features:

  • 🤖 Direct integration with Apple's on-device AI models
  • 🔒 Privacy-first approach (all processing happens on-device)
  • 📱 iOS 26+ support with Apple Intelligence
  • 🎯 Schema validation for structured AI responses
  • ⚡ Session management and temperature control
  • 📊 Device compatibility checking

🔗 View Repository · 📦 npm


💻 Tech Stack

Web & Mobile:

  • Angular, Ionic Framework, Capacitor
  • TypeScript/JavaScript, HTML & SCSS
  • Node.js, PHP, ASP.NET

Native & Systems:

  • Swift (iOS), Kotlin (Android)
  • C & Verilog (firmware, FPGA cores)
  • 65816 & SPC700 assembly (SNES)
  • Go, Bash, Linux

Data & Tools:

  • MySQL, SQL Server, Oracle, MongoDB, Redis
  • Xcode, Android Studio, npm/pnpm, Git
Ionic NodeJs Js Ts React HTML CSS Sass Bootstrap MySQL Linux PHP Github GitLab NPM Docker VsCode

📫 Let's Connect!

  • 🐦 Twitter: @ludufre
  • 💼 LinkedIn: Luan Freitas
  • 🌐 Portfolio: ludufre.com
  • 📧 Feel free to reach out for collaborations or questions about any of my projects!

🌟 Support My Work

If any of my plugins have helped you build something awesome, consider:

  • ⭐ Starring the repositories
  • 🐛 Reporting issues or suggesting features
  • 🤝 Contributing to the projects
  • ☕ Buy me a coffee

If you enjoy my open-source projects and would like to support my work, you can also make a voluntary contribution:

Thank you for supporting independent open-source development!

Building the tool I wanted to exist — whether that means a plugin, a library or a console's firmware.


"Buy Me A Coffee" Me Paga um Café

visitas

Pinned Loading

  1. capacitor-screenshot capacitor-screenshot Public

    This plugin take screenshot of the app

    TypeScript 18 12

  2. capacitor-lottie-splash-screen capacitor-lottie-splash-screen Public

    Lottie Splash Screen plugin for Ionic Capacitor

    Swift 21 6

  3. capacitor-app-attest capacitor-app-attest Public

    Apple Attest with Ionic Capacitor

    TypeScript 4 1

  4. ens160-sensor ens160-sensor Public

    A Node.js I2C module for the Adafruit ENS160 MOX Gas Sensor.

    JavaScript 1

  5. capacitor-live-activities capacitor-live-activities Public

    Ionic Capacitor plugin for Live Activities for iOS 16.2+

    TypeScript 19 6

  6. capacitor-foundation-models capacitor-foundation-models Public

    A Capacitor plugin that provides access to Apple's Foundation Models framework, enabling on-device AI interactions with privacy and performance in mind.

    TypeScript 3