IIDXwidget

OBS BROWSER SOURCE · WINDOWS · LINUX · FREE

방송 화면 위의
계기판.
A dashboard
for your stream.

IIDX·BMS 컨트롤러 입력을 OBS에 그대로. 스크래치와 건반, 릴리즈, KPS 스피드미터까지. 설치하고 주소 한 줄만 넣으면 끝입니다. Your IIDX/BMS controller, live on OBS. Turntable, keys, release timing and a KPS speedometer. Install it and add one URL.

MIT 라이선스 · 소스 공개 · 한국어 / English MIT licensed · open source · Korean / English

OBS · Browser Source · 800×600

01 IIDXwidget을 쓰는 이유Why IIDXwidget

투컴 방송 지원Two-PC streaming

게임 PC에서 앱을 켜고, 방송 PC의 OBS에 게임 PC 주소만 넣으면 됩니다. IP 찾는 법부터 방화벽 허용까지 앱 안의 연결 가이드가 차근차근 안내합니다. Run the app on the game PC and put its address into OBS on the stream PC. The built-in connection guide walks you through finding the IP and allowing it through the firewall.

채터링 감지 지원Chatter detection

스위치가 튀어서 생기는 이중 인식을 건반마다 셉니다. 유독 튀는 건반만 짚어 줘서 스위치 교체 시기를 가늠할 수 있습니다. Counts double inputs from switch bounce on every key and points out the keys that stand out, so you know when a switch is wearing out.

무료Free

모든 기능을 무료로 씁니다. 결제도, 광고도, 가입도 없습니다. Every feature is free. No payment, ads or sign-up.

02 이런 분께Made for

03 기능Features

실시간 입력 계기판Live input dashboard

스크래치 회전과 방향, 건반 입력을 실시간으로 그리고, 아래 계기판에 이번 세션의 타건 수와 업타임이 흐릅니다. Turntable spin and every key press, drawn live, with this session's presses and uptime on the dashboard.

가이드: 화면 구성 → Guide: what you see →

KPS 스피드미터KPS speedometer

KPS가 속도계처럼 올라가고, 빨간 영역에서는 주황에서 빨강으로 달아오르며 끝값에서 살짝 떨립니다. IIDX / BMS ~★★ / BMS ★★~ 프리셋. KPS climbs like a speedometer, heats from orange to red in the red zone and trembles at the limit. Presets for IIDX, BMS up to ★★, and BMS ★★ and up.

가이드: KPS 스피드미터 → Guide: KPS speedometer →

릴리즈 · 롱노트Release and long notes

건반 위 숫자는 건반별, 계기판은 전체 평균 릴리즈입니다. Rag 님 위젯과 같은 규칙으로 재고, 롱노트는 평균에서 빼며 누르고 있는 동안 따로 색을 칠합니다. Per-key release above each key and the overall average on the dashboard, with the same rules as Rag's widget. Long notes are left out and get their own color while held.

가이드: RELEASE 수치 → Guide: release value →

DP 지원DP support

1P와 2P에 컨트롤러를 각각 연결합니다. 종류가 달라도 되고, 같은 컨트롤러 두 대라면 장치를 골라 쓰면 됩니다. 위젯은 하나로 이어지고 계기판은 가운데에 붙습니다. Connect a controller to 1P and 2P separately. Different models are fine, and with two identical ones you pick each device. The widget joins into one with the dashboard in the middle.

가이드: 버튼 레이아웃과 DP → Guide: button layout and DP →

방송에 맞춰 꾸미기Make it yours

스크래치에 원하는 이미지를 넣고, 이미지에 맞춰 배경·건반·입력·글자·롱노트 색을 바꿉니다. GIF 등 움직이는 이미지도 지원하고, 회전 방향마다 다른 이미지도 됩니다. 이미지에서 어울리는 색을 알아서 뽑아 주는 추천 색상도 켤 수 있습니다. 바꾼 설정은 방송 화면에 바로 반영됩니다. Put your own image on the turntable and set the background, key (idle/active), text and long-note colors to match it. Animated images like GIFs work too, and you can use a different image per spin direction. Turn on recommended colors to have them picked from your image automatically. Changes show up on stream instantly.

가이드: 위젯 외관 → Guide: widget appearance →

채터링 감지Chatter detection

스위치가 튀어서 생기는 이중 인식을 건반마다 셉니다. 흰 건반과 검은 건반을 따로 묶어 유독 튀는 건반만 빨갛게 표시하고, Rag / Coldlapse 두 가지 기준 중에 고를 수 있습니다. Counts switch bounce per key. White and black keys are compared separately and only the outliers light up red. Choose between the Rag and Coldlapse presets.

가이드: 채터링 감지 → Guide: chatter detection →

beatmania.app 타건 기록beatmania.app play count

계정을 한 번 연결하면 버튼 하나로 이번 세션의 타건 수를 서열표 사이트에 보냅니다. 끌 때 자동으로 보낼 수도 있습니다. Connect your account once, then send this session's presses with one click, or automatically when you quit.

가이드 → Guide →

컨트롤러와 장치 선택Controllers and devices

PHOENIXWAN+ · PHOENIXWAN+ LMT Classic · RED-LMS · FPS EMP 2세대 · arcin-infinitas · 키보드를 공식 지원하고, 그 밖의 컨트롤러는 버튼을 눌러 직접 매핑합니다. 연결된 장치를 골라 쓸 수 있습니다. Official support for PHOENIXWAN+, PHOENIXWAN+ LMT Classic, RED-LMS, FPS EMP Gen2, arcin-infinitas and keyboards; other controllers can be mapped by hand (not guaranteed). Pick from the connected devices.

지원 컨트롤러 · 지원 요청 → Supported controllers · requests →

앱 안의 가이드Guides built in

연결 방법, 설정, 릴리즈, 채터링 가이드를 앱 안에서 바로 봅니다. 늘 최신 내용으로 불러옵니다. Connection, settings, release and chatter guides inside the app, always the latest version from GitHub.

연결 가이드 → Connection guide →

알아서 다시 연결Reconnects on its own

앱이 꺼져 있으면 방송 화면에 안내를 띄우고, 앱을 켜는 순간 다시 붙습니다. OBS를 건드릴 필요가 없습니다. 컨트롤러 케이블을 뺐다 꽂아도 재시작 없이 다시 연결됩니다. If the app is off, the stream shows a notice; start the app and it reconnects. No need to touch OBS. Unplug and replug the controller and it reconnects without a restart.

문제 해결 → Troubleshooting →

리눅스도 됩니다 (실험적)Linux too (experimental)

Windows 설치 파일과 함께 리눅스용 AppImage를 배포합니다. 자동 업데이트도 됩니다. 컨트롤러 입력은 아직 리눅스 실제 기기로 확인하는 중이라 실험적으로 지원합니다. 키보드 모드는 X11 창(Wayland에서는 XWayland 창)에 포커스가 있을 때 동작합니다. An AppImage ships alongside the Windows installer, with auto-update. Controller input is still being confirmed on real Linux hardware, so support is experimental; keyboard mode works while an X11 window (an XWayland window on Wayland) has focus.

리눅스 안내 → Linux notes →

04 지원하는 컨트롤러Supported controllers

공식 지원Official

  • PHOENIXWAN+ (주작콘)
  • PHOENIXWAN+ LMT Classic
  • RED-LMS
  • arcin-infinitas
  • FPS EMP 2세대Gen2
  • 키보드Keyboard

프로필을 고르기만 하면 바로 동작합니다. 주작콘·FPS·LMT Classic은 'LR2 모드 감지'를 켜면 LR2 모드도 따라가고, arcin-infinitas는 턴테이블 모드를 알아서 따라갑니다. Pick the profile and it works right away. PHOENIXWAN+, FPS and LMT Classic follow LR2 mode with 'Detect LR2 mode' on, and arcin-infinitas follows its turntable mode on its own.

수동 매핑 · 보장 안 함Manual mapping · not guaranteed

  • 그 밖의 IIDX 컨트롤러 (게임패드 모드)Other IIDX controllers (gamepad mode)
  • 아두이노 등 자작 기판DIY boards (Arduino, …)
  • PS2 컨트롤러 + USB 변환기PS2 controllers via USB adapter

'기타 컨트롤러 (수동 매핑)' 프로필에서 버튼을 눌러 직접 매핑합니다. Map each button yourself with the 'Other controller (manual mapping)' profile.

확인된 기타 컨트롤러Confirmed (manual mapping)

아직 없습니다. 수동 매핑으로 써 보셨다면 결과를 알려주세요. None yet. If you've used one with manual mapping, let us know how it went.

지원 범위 자세히 → Support details →

내 컨트롤러도 공식 지원해 주세요Request official support

컨트롤러가 보내는 신호를 기록해서 보내 주시면 그걸로 전용 프로필을 만듭니다. 앱 안에서 몇 분이면 됩니다. Record what your controller sends and share it. We build dedicated profiles from that recording. It takes a few minutes inside the app.

  1. IIDXwidget의 메뉴 → 컨트롤러 정보 수집을 열고, 안내대로 버튼을 누르고 턴테이블을 돌리며 녹화합니다. In IIDXwidget, open Menu → Controller probe and record while pressing buttons and turning the turntable as it asks.
  2. 결과 파일 저장으로 JSON 파일을 저장합니다. Press Save result file to save a JSON file.
  3. GitHub의 컨트롤러 지원 요청 이슈 양식을 열고, '수집 파일' 칸에 JSON 파일을 끌어다 놓아 첨부한 뒤 등록합니다. Open the controller support request issue form on GitHub, drag the JSON file into the 'Probe file' box, and submit.

GitHub 계정이 필요합니다. 파일이 25MB를 넘으면 ZIP으로 압축해 주세요. 요청한다고 공식 지원이 보장되지는 않으며 실물 확인이 필요할 수도 있습니다. A GitHub account is required. Zip the file if it's over 25MB. A request doesn't guarantee support, and we may need to test the hardware.

05 3분이면 시작Up in three minutes

  1. 1설치 파일을 받아 실행합니다. 리눅스는 AppImage(실험적)이며 리눅스 안내를 봐 주세요.Download and run the installer. On Linux, use the AppImage (experimental). See the Linux notes.
  2. 2OBS에 브라우저 소스를 추가하고 http://127.0.0.1:8080/widget/을 넣습니다. (800×600, DP는 1320×600) Add an OBS browser source with http://127.0.0.1:8080/widget/ (800×600, or 1320×600 for DP).
  3. 3설정에서 컨트롤러를 고르면 끝.Pick your controller in Settings. Done.

06 만든 사람Who made it

Coldlapse

Coldlapse

2022년에 IIDX와 BMS를 시작한 플레이어입니다. IIDX 인피니타스를 위한 서열표 사이트가 없어서 beatmania.app을 만들어 운영하고 있고, IIDXwidget도 그 연장선에서 개발했습니다. 방송하며 직접 쓰는 도구를 만듭니다.

A player who started IIDX and BMS in 2022. Noticing that INFINITAS had no rank-table site of its own, Coldlapse built and runs beatmania.app. IIDXwidget came from the same place: a tool built for actual use on stream.

함께 만든 사람들Contributors: rhombus9 · 멘탈바사삭 · MellDa1024 · Ryochobi