Automation15 min read

NOALBS 설정 가이드

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

NOALBS는 어떤 기능을 하나요?

비트레이트 모니터링

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

연결 끊김 감지

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

채팅 명령어

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

자동 복구

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

NOALBS Cloud: 설치할 필요 없음

NOALBS Cloud는 NOALBS 원작자가 만든 호스팅 버전입니다. 온라인에서 실행되므로 내려받거나 컴퓨터에 계속 켜 둘 필요가 없습니다. Twitch 또는 Kick으로 로그인하면 OBS가 브라우저 소스를 통해 연결됩니다.

NOALBS를 직접 운영하고 싶으신가요? 아래의 사전 준비 사항과 설정 단계에서 PC에 NOALBS를 설치하는 방법을 확인하세요.

클릭 한 번으로 엔드포인트 추가

  1. IRLServer 대시보드에서 엔드포인트를 여세요.
  2. Connect 탭에서 "Switch scenes automatically"를 열고 "Prefer NOALBS?"를 선택한 다음 NOALBS Cloud를 고르세요.
  3. "Add to NOALBS Cloud"를 클릭하세요. 로그인한 뒤 추가할 스위처를 선택하고 확인합니다.
  4. NOALBS Cloud에서 설정을 마무리하세요. OBS에 브라우저 소스를 추가하고 LIVE, LOW, BRB 씬을 선택합니다.
버튼에 연결된 링크에는 비밀번호처럼 작동하는 스트림 경로가 들어 있습니다. 다른 사람과 공유하지 마세요.

또는 직접 추가

  1. next.noalbs.com에 로그인한 다음 스위처를 여세요.
  2. Stream servers로 이동해 서버를 추가하고 SLS (SRT Live Server)를 선택하세요.
  3. 엔드포인트의 Connect 탭에 있는 NOALBS Cloud 옵션에서 통계 URL과 publisher를 복사하세요. 붙여넣은 뒤 저장합니다.

IRLControl: 직접 제공하는 호스팅 옵션

IRLControl은 저희가 직접 운영하는 호스팅 스위처이며 무료입니다. NOALBS와 동일한 전환 규칙을 사용하고 NOALBS config.json을 가져올 수 있어, 트리거와 씬, stream 서버가 그대로 옮겨집니다. 전환 기능에 더해 stream 상태를 한 화면에서 보여 주고, 모더레이터가 채팅에서 stream을 운영할 수 있게 해 줍니다.

NOALBS Cloud, IRLControl, 그리고 PC에서 실행하는 NOALBS 모두 IRLServer 엔드포인트와 함께 작동합니다. 취향에 맞는 것을 고르세요.

IRLControl 열기

사전 준비 사항

  • 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 토큰 생성하기