콘텐츠로 이동
Audiotext

설치

Audiotext는 Windows, macOS, Linux용 데스크톱 앱입니다. 파일, YouTube 동영상, 마이크 녹음의 오디오를 텍스트로 받아쓰고, 번역, 요약, 자막 생성도 할 수 있습니다.

앱 다운로드

섹션 제목: “앱 다운로드”

GitHub의 최신 릴리스에서 사용하는 시스템용 파일을 다운로드하세요.

시스템 파일
Windows(64비트) Audiotext-<version>-windows-x64-setup.exe
macOS 15 이상(Apple Silicon) Audiotext-<version>-macos-arm64.dmg
Linux(x86_64) Audiotext-<version>-linux-x86_64.tar.gz

앱에는 FFmpeg를 포함해 필요한 모든 것이 들어 있습니다.

Windows

섹션 제목: “Windows”

설치 프로그램을 실행하고 단계를 따르세요. 관리자 권한이 필요하지 않습니다. NVIDIA GPU가 있다면 NVIDIA GPU(CUDA)를 사용하는 옵션을 선택하세요. 설치 프로그램이 GPU 애드온을 다운로드해 WhisperX가 훨씬 빨라집니다. 설치 프로그램에 서명이 없으므로 Windows SmartScreen이 경고를 표시할 수 있습니다. 추가 정보를 열고 그래도 실행하도록 선택하세요.

macOS

섹션 제목: “macOS”

.dmg 파일을 열고 Audiotext를 응용 프로그램 폴더로 끌어다 놓으세요. 이 앱은 Apple의 공증을 받지 않았으므로 처음 열 때 macOS가 차단합니다. 시스템 설정 → 개인정보 보호 및 보안으로 이동해 Audiotext 관련 메시지 옆의 그래도 열기를 클릭하세요. Mac에서는 WhisperX가 MLX Whisper로 Apple 실리콘의 GPU에서 받아쓰므로, 추가 구성 요소 없이 CPU보다 훨씬 빠릅니다. PyTorch가 더 이상 지원하지 않으므로 Intel Mac은 지원되지 않습니다.

Linux

섹션 제목: “Linux”

압축을 풀고 터미널에서 설치 프로그램을 실행하세요.

터미널 창
tar -xzf Audiotext-<version>-linux-x86_64.tar.gz
cd Audiotext-<version>-linux-x86_64
./install.sh

Audiotext를 현재 사용자용으로 설치하고 응용 프로그램 메뉴에 추가합니다(audiotext 명령으로도 열 수 있습니다). NVIDIA GPU를 감지하면 GPU 애드온 다운로드를 제안합니다. 묻지 않고 선택하려면 ./install.sh --gpu 또는 ./install.sh --cpu를, 제거하려면 ./install.sh --uninstall을 실행하세요(설정은 유지됩니다).

요구 사항

섹션 제목: “요구 사항”
  • WhisperX는 내 컴퓨터에서 실행됩니다. 어떤 CPU에서도 작동하지만 CUDA를 지원하는 NVIDIA GPU나 Apple 실리콘 Mac의 GPU에서 훨씬 빠릅니다. 하드웨어에 맞는 모델을 고르려면 엔진을 참고하세요.
  • Whisper API와 Google API는 원격 서버에서 실행되므로 인터넷 연결이 필요하지만 고성능 하드웨어는 필요하지 않습니다.
  • 마이크에서 받아쓰려면 시스템이 입력 장치를 인식해야 합니다.
  • Linux에서 녹음과 재생에는 PortAudio가 필요합니다(Ubuntu 또는 Debian에서는 sudo apt install libportaudio2).

앱 업데이트

섹션 제목: “앱 업데이트”

새 버전이 나오면 Audiotext는 위쪽 막대에 버전 … 사용 가능 버튼을 표시합니다. 버튼을 클릭해 릴리스 페이지를 열고, 시스템에 맞는 파일을 다운로드한 뒤 처음과 같이 설치하세요. Windows에서는 새 설치 프로그램을 실행하고, macOS에서는 새 앱을 응용 프로그램 폴더로 드래그하고, Linux에서는 새 압축 파일의 install.sh를 실행합니다. 이전 버전은 교체되지만 설정과 기록은 사용자 설정 폴더에 저장되어 있으므로 그대로 유지됩니다. GPU 애드온을 사용한다면 설치할 때 다시 선택하세요.

새 버전을 직접 확인하려면 환경설정 → 정보 → 업데이트 확인을 여세요. 앱을 열 때 확인하지 않으려면 일반 → 자동으로 업데이트 확인를 끄세요.

앱 제거

섹션 제목: “앱 제거”
  • Windows: 다른 앱과 마찬가지로 설정 → 앱에서 제거합니다.
  • macOS: Audiotext를 응용 프로그램 폴더에서 휴지통으로 드래그합니다.
  • Linux: 압축 파일의 폴더에서 ./install.sh --uninstall을 실행합니다. 폴더가 더 이상 없다면 ~/.local/share/audiotext, ~/.local/bin/audiotext, ~/.local/share/applications/audiotext.desktop을 삭제하세요.

설정, 기록, 녹음은 유지되므로 다시 설치해도 그대로 남아 있습니다. 모두 지우려면:

  1. 제거하기 전에 환경설정 → API 키에서 API 키를 삭제하세요(**변경…**를 클릭하고 비워 두세요). API 키는 시스템의 자격 증명 저장소에 보관되기 때문입니다.
  2. 사용자 설정 폴더를 삭제하세요.
  3. 다운로드된 모델을 삭제하세요.

인터페이스 언어 변경

섹션 제목: “인터페이스 언어 변경”

Audiotext는 사용 가능한 경우 시스템 언어를 사용합니다. 바꾸려면 환경설정(오른쪽 위의 톱니바퀴)을 열고 일반 → 인터페이스 언어에서 언어를 고르세요.

소스 코드에서 실행

섹션 제목: “소스 코드에서 실행”

최신 코드를 실행하거나 기여하고 싶다면 기여하기를 참고해 Python으로 프로젝트를 준비하세요.

다음 단계

섹션 제목: “다음 단계”