Automation15 min read

NOALBS 설정 가이드

NOALBS(Nginx OBS Automatic Low Bitrate Switching)는 스트림 상태를 모니터링하고, 연결이 끊기거나 비트레이트가 낮아지면 OBS 씬을 자동으로 전환합니다. 이렇게 하면 연결 문제를 겪는 중에도 시청자의 몰입을 유지할 수 있습니다.

NOALBS는 어떤 기능을 하나요?

비트레이트 모니터링

스트림 비트레이트를 실시간으로 모니터링합니다. 비트레이트가 설정한 기준값 아래로 떨어지면 NOALBS가 자동으로 LOW 또는 BRB 씬으로 전환합니다.

연결 끊김 감지

인코더 연결이 완전히 끊기면 이를 감지해 BRB 씬으로 전환하므로, 시청자는 멈춘 화면 대신 다른 화면을 보게 됩니다.

채팅 명령어

Twitch/Kick 채팅에서 OBS를 제어하세요. 컴퓨터를 직접 건드리지 않고도 씬 전환, 비트레이트 확인, 스트림 관리를 할 수 있습니다.

자동 복구

연결이 복구되면 설정 가능한 재시도 로직에 따라 자동으로 LIVE 씬으로 다시 전환합니다.

사전 준비 사항

  • WebSocket이 활성화된 OBS Studio(OBS 28+에는 기본 탑재)
  • OBS에서 만든 씬: LIVE, LOW, BRB(선택 사항: REFRESH, STARTING, ENDING)
  • stats URL이 있는 IRLServer 엔드포인트(대시보드에서 확인 가능)
  • NOALBS를 실행할 Windows, macOS 또는 Linux 컴퓨터

설정 단계

1

Download NOALBS

GitHub에서 최신 NOALBS 릴리스를 다운로드하세요. 사용 중인 운영체제에 맞는 버전을 선택하세요:

GitHub에서 다운로드
다운로드한 ZIP 파일을 컴퓨터의 폴더에 압축 해제하세요. NOALBS 실행 파일과 config.json 파일이 들어 있습니다.
2

Enable OBS WebSocket

NOALBS는 WebSocket을 통해 OBS와 통신합니다. OBS에서 이를 활성화하세요:

  1. OBS Studio를 여세요
  2. 도구 → WebSocket Server Settings로 이동하세요
  3. "Enable WebSocket server"를 체크하세요
  4. 비밀번호를 설정하세요(NOALBS 설정에 필요합니다)
  5. 포트를 확인해 두세요(기본값은 4455입니다)
3

Create Your Scenes

OBS에서 다음 씬을 만드세요:

  • LIVE미디어 소스가 포함된 기본 스트리밍 씬
  • LOWbitrate가 낮을 때 표시됨(피드 + 경고 포함 가능)
  • BRB연결이 끊겼을 때 표시됨(클립 플레이어, 정적 이미지 등)
  • REFRESH(선택 사항) 미디어 소스를 새로 고치는 동안 표시됨
씬 이름은 대소문자를 구분합니다. config에 입력한 값과 정확히 일치해야 합니다.
4

Configure NOALBS

설정에 맞게 config.json 파일을 수정하세요. 간편하게 설정하려면 설정 생성기를 사용하세요:

NOALBS 설정 생성기 열기

구성해야 할 주요 설정:

  • OBS WebSocket 호스트, 포트, 비밀번호
  • IRLServer 대시보드의 stats URL
  • 비트레이트 트리거(예: 800 kbps 미만이면 LOW로 전환)
  • OBS 씬과 정확히 일치하는 씬 이름
5

Setup Chat Integration (Optional)

Twitch 채팅 명령어를 사용하려면 Twitch OAuth 토큰이 필요합니다. NOALBS 폴더에 .env 파일을 만드세요:

TWITCH_BOT_USERNAME=your_bot_username
TWITCH_BOT_OAUTH=oauth:your_token_here

twitchtokengenerator.com에서 OAuth 토큰을 받아오세요

6

Run NOALBS

NOALBS 실행 파일을 실행하세요. OBS에 연결된 후 스트림 통계 모니터링이 시작될 것입니다.

방송할 때는 항상 NOALBS를 실행해 두세요. 시스템 트레이로 최소화하거나 서비스로 실행할 수 있습니다.

채팅 명령어

NOALBS는 권한 수준별로 정리된 다양한 채팅 명령어를 지원합니다. 기본 접두사는 "!"입니다.

관리자 명령어

!start

Start streaming in OBS

Admin
!stop

Stop streaming in OBS

Admin
!switch [scene]

Switch to a specific scene

Admin
!live

Switch to LIVE scene

Admin
!privacy

Switch to privacy scene

Admin
!record

Toggle recording

Admin

모더레이터 명령어

!trigger [value]

Set low bitrate trigger threshold (kbps)

Mod
!otrigger [value]

Set offline trigger threshold (kbps)

Mod
!fix / !refresh

Try to fix the stream (refresh media source)

Mod
!sourceinfo

Show current source information

Mod

일반 사용자 명령어

!bitrate

Show current stream bitrate

Public

문제 해결

NOALBS가 OBS에 연결되지 않는 경우: OBS에서 WebSocket이 활성화되어 있는지, 그리고 설정 파일의 비밀번호/포트가 OBS 설정과 일치하는지 확인하세요.
장면 전환이 작동하지 않는 경우: config.json의 장면 이름이 OBS 장면 이름과 정확히 일치하는지 확인하세요(대소문자 구분).
Stats URL에서 오류가 발생하는 경우: 인코더가 해당 endpoint로 스트리밍하고 있는지 확인하세요. 브라우저에서 Stats URL을 열었을 때 JSON 데이터가 표시되어야 합니다.
도움이 필요하신가요? Discord에 참여하거나 NOALBS Wiki를 확인해 보세요.

리소스

설정 생성기

config.json 생성하기

NOALBS GitHub

소스 코드 및 릴리스

OBS 설정 가이드

IRL 스트리밍을 위한 OBS 설정

OAuth 토큰 생성기

Twitch OAuth 토큰 생성하기