Repolode
tembo

tembo/voxl

Rust로 구현한 저지연 웹 원격 데스크톱 스트리밍으로, WebSocket으로 H.264를 전송하고 브라우저에서 WebCodecs로 디코딩합니다.

스타
1,293
포크
71
열린 이슈
6
마지막 커밋
23시간 전

어떤 프로젝트인가요?

voxl은 X11 디스플레이, macOS 화면 또는 Windows 데스크톱을 웹 브라우저로 스트리밍합니다. 서버는 화면을 캡처해 x264로 H.264 인코딩한 뒤 단일 WebSocket을 통해 프레임을 전송합니다. 함께 제공되는 웹 클라이언트는 WebCodecs로 프레임을 디코딩하고 키보드, 마우스, 클립보드, 오디오, 마이크, 파일 전송 및 동적 해상도 제어를 호스트로 전달합니다.

이 프로젝트는 보통 GPU 없이 Xvfb를 실행하는 헤드리스 VM, 샌드박스 및 CI 환경을 대상으로 합니다. 이런 환경에서 컴퓨터 조작 에이전트나 사용자가 브라우저 탭에서 데스크톱을 보고 제어할 수 있습니다. 기본적으로 비밀번호 로그인을 사용하고 호스트 및 Origin을 검사하며, 스크린샷과 MP4 녹화, 화면이 안정되거나 바뀔 때까지 대기하는 /wait 호출을 위한 HTTP 엔드포인트를 제공합니다.

crates.io에서 voxl-server로 설치할 수 있으며 Rust로 빌드합니다. Linux에서는 x264, libyuv, Opus 및 PulseAudio에 의존하고, macOS와 Windows에서는 Homebrew 또는 vcpkg를 사용합니다.

핵심 기능

  • 01X11, macOS 및 Windows 데스크톱을 단일 WebSocket으로 H.264 스트리밍합니다.
  • 02WebRTC 지터 버퍼 없이 브라우저에서 WebCodecs로 디코딩합니다.
  • 03입력, 클립보드, 데스크톱 오디오, 마이크 및 파일·폴더 전송을 지원합니다.
  • 04뷰어 창 크기에 맞춰 해상도를 조정합니다.
  • 05스크린샷, MP4 녹화 및 화면 변경 대기를 위한 HTTP 엔드포인트를 제공합니다.
  • 06기본적으로 비밀번호를 요구하고 Host 및 Origin 헤더를 검사합니다.

활용 사례

  • 브라우저에서 CI 작업, VM 또는 샌드박스 안의 데스크톱을 보거나 제어합니다.
  • 컴퓨터 조작 AI 에이전트에 스크린샷과 녹화본을 제공하고 UI 변경을 기다리게 합니다.
  • iframe을 통해 원격 데스크톱 화면을 다른 웹 페이지에 삽입합니다.
  • 클라이언트 앱을 설치하지 않고 브라우저에서 Mac 또는 Windows 컴퓨터의 화면에 접속합니다.

빠른 시작

  1. 1

    crates.io에서 voxl-server를 설치합니다(시스템에 x264, libyuv, Opus, PulseAudio, esbuild가 필요합니다).

    cargo install voxl-server
  2. 2

    display :1을 대상으로 voxl을 실행한 다음, 로그인하려면 출력된 링크를 엽니다.

    DISPLAY=:1 voxl

사용 전 알아둘 점

  • 제공된 nix-shell을 사용하지 않는 경우, 먼저 여러 네이티브 라이브러리(x264, libyuv, Opus, PulseAudio, esbuild)를 설치해야 합니다.
  • --stripes와 같은 실험적 옵션은 README에서 실험적 기능으로 표시되어 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

voxl은(는) 무엇인가요?
Rust로 구현한 저지연 웹 원격 데스크톱 스트리밍으로, WebSocket으로 H.264를 전송하고 브라우저에서 WebCodecs로 디코딩합니다. voxl은 X11 디스플레이, macOS 화면 또는 Windows 데스크톱을 웹 브라우저로 스트리밍합니다. 서버는 화면을 캡처해 x264로 H.264 인코딩한 뒤 단일 WebSocket을 통해 프레임을 전송합니다. 함께 제공되는 웹 클라이언트는 WebCodecs로 프레임을 디코딩하고 키보드, 마우스, 클립보드, 오디오, 마이크, 파일 전송 및 동적 해상도 제어를 호스트로 전달합니다.
voxl은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
voxl은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
voxl은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. voxl의 마지막 커밋은 2026년 11월 7일입니다.
voxl은(는) 어디에 사용할 수 있나요?
브라우저에서 CI 작업, VM 또는 샌드박스 안의 데스크톱을 보거나 제어합니다. 컴퓨터 조작 AI 에이전트에 스크린샷과 녹화본을 제공하고 UI 변경을 기다리게 합니다. iframe을 통해 원격 데스크톱 화면을 다른 웹 페이지에 삽입합니다. 클라이언트 앱을 설치하지 않고 브라우저에서 Mac 또는 Windows 컴퓨터의 화면에 접속합니다.
voxl는 어떻게 설치하나요?
crates.io에서 voxl-server를 설치합니다(시스템에 x264, libyuv, Opus, PulseAudio, esbuild가 필요합니다).: cargo install voxl-server display :1을 대상으로 voxl을 실행한 다음, 로그인하려면 출력된 링크를 엽니다.: DISPLAY=:1 voxl
voxl은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tembo/voxl

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트