Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

69 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

DeviceBuddy

A universal controller diagnostic, display, and testing utility. The next-generation GamePad Viewer built on WebHID and WebUSB.


๐Ÿšง Project Status ๐Ÿšง

DeviceBuddy is a work in progress.

If you found this project, you probably stumbled across it early.
It is new, so expect bugs, missing features, and frequent changes.

๐ŸŒ Online version: https://ulao.github.io/DeviceBuddy/

Anyone interested in development can go to https://discord.gg/KvVWhwH3U and join the #DeviceBuddy discussion. or enter an issue on GitHub.


About

DeviceBuddy is a quick and flexible controller utility designed to replace the many limited controller testers currently available.

The goal is to support as many controllers as possible while remaining configurable and expandable.

This is not an exclusive Bliss-Box tool. Support will be added for any controller hardware that can be identified and communicated with.


Current Version

V1.1 - Hello World Release

This is the first public version.

Current status:

  • Bliss-Box API support is implemented, including device flashing.
  • Tested with multiple controllers
  • Windows support
  • Linux support
  • WebHID/WebHID controller communication

Why WebHID or WebUSB and not Gamepad API ?

The Gamepad API is great, and there are many excellent gamepad testers available that use it. Device Buddy takes a different approach.

The Gamepad API is designed to expose standard controller inputsโ€”buttons, analog sticks, but it doesn't provide access to advanced USB HID features such as control transfers, feature reports, or vendor-specific data. Because of these limitations, browser-based tools have traditionally been unable to fully configure, map, or communicate with advanced controller adapters.

By using WebHID/WebUSB instead of the Gamepad API, Device Buddy can communicate directly with supported hardware. This makes it possible to perform advanced mapping, configure device settings, update firmware, and access features that were previously only available through desktop software.

As a result, industry-leading adapters such as Bliss-Box and Raphnet can now be fully configured and managed directly from a web browserโ€”no software installation required.


Supported Controllers

System Support
3DO โœ…
Atari 2600 โœ…
Atari 5200 โœ…
Atari 7800 โœ…
Atari Paddles โœ…
Bally Astrocade โœ…
Gemini Paddle โœ…
Philips CD-i โœ…
Sega Dreamcast โœ…
Nintendo GameCube โœ…
Sega Genesis (3 Button) โœ…
Sega Genesis (6 Button) โœ…
Sega Paddle โœ…
Atari Jaguar โœ…
Neo Geo โœ…
Nintendo Entertainment System โœ…
Nintendo 64 โœ…
Nintendo VAUS Paddle โœ…
Nintendo Wii Controller โœ…
Nintendo Wii Nunchuck โœ…
Attmark Pippin โœ…
Sony PlayStation โœ…
Sony PlayStation 4 โœ…
Sega Saturn โœ…
Sega Saturn 3D Stick โœ…
Super Nintendo โœ…
TurboGrafx-16 โœ…
PC Engine โœ…
Virtual Boy โœ…
Xbox One โœ…
Xbox 360 โœ…
Xbox Original โœ…
Nintendo Switch โœ…

Windows Notes

If you download the source and want to run DeviceBuddy locally, Chromium-based browsers are required.

Tested browsers:

  • Chrome
  • Opera
  • Edge

Launch with:

Chrome

chrome.exe --allow-file-access-from-files --disable-web-security --user-data-dir="C:\temp\chrome_dev"

Opera

"C:\Program Files\Opera\launcher.exe" --allow-file-access-from-files --disable-web-security --disable-site-isolation-trials --user-data-dir="C:\temp\opera_dev"

Edge

"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --allow-file-access-from-files --disable-web-security --disable-site-isolation-trials --user-data-dir="C:\temp\edge_dev"

Linux Notes

Linux users may need HID permissions.

Find your device name:

mcs-gamer-pro

Create:

sudo nano /etc/udev/rules.d/99-mcs-gamer-pro.rules

Add:

exmaple Bliss-Box port 1

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0d04", MODE="0666"

example Bliss-Box bootloader updater:

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="04fb", MODE="0666"

Reload rules:

sudo udevadm control --reload-rules
sudo udevadm trigger

OBS overlay

Within the app you can press Scroll Lock to hide everything except the controller. You can also choose your own controller fill color.

In OBS, use Window Capture for the browser window.

image

To crop, hold Alt while dragging the edges of the source to crop the image.

image

Right-click your Window Capture source in OBS and choose Filters .Click the + button under Effect Filters (on the bottom left). Select Color Key (do not choose Chroma Key) and name it. Choose Custom Color from the Key Color Type. Set the Key Color Type to Custom Color .Click Select Color, choose pure White, and click OK. If done correctly, you'll have a controller overlay.

image

if done right you will have a comtroller overlay

image

License

This project is not open source.

Copyright (c) 2026 Bliss-Box LLC

Permission to use, modify, or redistribute this code is granted only if:

  • This copyright notice remains.
  • The Bliss-Box logo remains visible.
  • A visible link to https://bliss-box.com remains on the page.
  • Derivative works continue to display this attribution.

Bliss-Boxยฎ and the Bliss-Box logo are trademarks of Bliss-Box LLC.

All rights reserved.


Screenshots

Controller Display with fill options

image image image

Diagnostics

image

Mapping

image image

Features

image image image

** Overlays

image

๐ŸŽฎ What is Bliss-Box?

Bliss-Box makes old and new game hardware work together.

Whether it's a controller from the 1980s, or an arcade stick you built yourself, Bliss-Box products let you connect the controller you love to the system you want to play.

Instead of replacing your favorite controllers, Bliss-Box gives them a new life.


๐Ÿš€ Three Ways Bliss-Box Makes Gaming Better

๐ŸŽฎ Input Adapters

Use almost any controller on your PC.

Plug classic console controllers, arcade sticks, fight sticks, racing wheels, and specialty controllers into a single USB adapter.

  • โœ… No soldering
  • โœ… No complicated setup
  • โœ… Just play
  • โœ… Lowest lag posible

Perfect for:

  • Steam
  • RetroArch
  • MAME
  • FPGA systems
  • Emulators
  • Modern PC games

๐Ÿ”„ Bridge Adapters

Make controllers and consoles speak the same language.

Bridge adapters translate one controller protocol into another in real time.

For example, use a USB controller on hardware that normally doesn't support USBโ€”or connect controllers between entirely different gaming ecosystems.

Think of it as a universal interpreter for game controllers.


โšก Specialty Adapters

Do things other adapters simply can't.

Products like the Bliss-Box Air and Bliss-Box Blender solve unique controller challenges that standard adapters ignore.

Whether it's wireless connectivity, combining multiple controller technologies, or enabling specialized hardware, these devices are designed for gamers who want maximum flexibility.


โญ Why Gamers Choose Bliss-Box

โœ” Use the controller you already love

Keep using your favorite controller instead of buying a replacement.


โœ” Huge controller compatibility

Support for 100+ controller types spanning decades of gaming history.


โœ” Built for enthusiasts

Ideal for:

  • Retro gamers
  • Arcade builders
  • Speedrunners
  • FPGA users
  • Collectors
  • Hardware developers

โœ” Low latency

Fast, responsive performance designed specifically for gamingโ€”not generic USB conversion.


โœ” Constantly evolving

New controller support and firmware updates continue to expand what the hardware can do.


โœ” Designed by gamers

Every product is created by someone who actually uses classic gaming hardwareโ€”not just someone selling adapters.


โœ” Do what the controller can

At Bliss-Box, we believe you should be able to use your controller to its full potential. Whenever possible, we push beyond the standard limitations to support advanced features such as pressure-sensitive buttons, gyroscopes, LCD displays, memory card access, and much more.

Take a look at the source code behind Device Buddy to see what's possible with the API. Its straightforward interface makes it easy to access powerful controller features that are typically unavailable through conventional gamepad APIs.

Our goal is simple: give developers and gamers complete access to their hardware so they can enjoy the best possible gaming experience.


๐ŸŒŸ The Bliss-Box Difference

Many adapters solve only one problem:

"This controller works on this console."

Bliss-Box is different.

It is an entire ecosystem built around one idea:

Every great controller deserves to work everywhere.

Whether you're preserving gaming history, building the ultimate arcade cabinet, speedrunning with original hardware, or simply playing with the controller that feels best in your hands, Bliss-Box removes the barriers between generations of gaming.

Bliss-Box LLC Bliss-Box.com](https://bliss-box.com)

About

Config, display, and take your controller anywhere.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages