Nginx·Apache 등 별도의 웹 서버 설치 없이, Python + FastAPI + Uvicorn + FFmpeg만으로 로컬 PC에서 Audio Toolkit을 즐기자!
외부 웹 오디오 변환 서비스에 의존하지 않고,
자신의 PC(Linux·Windows·macOS)에 직접 설치하고 운영할 수 있는 로컬 자체 호스팅(Self-hosting) 오디오 처리 도구를 목표로 합니다.
오디오 파일을 외부 서비스에 전송하지 않고 자신의 환경에서 직접 처리할 수 있도록 하여 데이터 관리와 프라이버시를 중시하는 사용 환경을 목표로 했습니다.
특히 개발 환경과 운영 환경의 일관성을 고려하여 Python + FastAPI + Uvicorn 조합을 채택하고, 오디오 변환·편집에는 FFmpeg를 활용했습니다.
Docker, Nginx, Apache 또는 별도의 데이터베이스 서버 없이 Python 가상환경과 FFmpeg만으로 실행할 수 있습니다.
물론, 필요에 따라 Nginx·Apache 등의 기존 웹 서버와 연동하여 외부에 서비스를 제공하는 것도 가능합니다.
별도의 웹 서버가 필요 없다는 것은 사용이 제한된다는 의미가 아니라,
웹 서버 설치 없이도 독립적으로 실행할 수 있다는 의미입니다.
※ 주요 기능
-
오디오 형식 변환: MP3, WAV, FLAC, OGG, Opus, M4A 출력 지원(설치된 FFmpeg 코덱에 따라 상이)
-
오디오 편집: 구간 자르기, 선택 구간 제거, 볼륨 조절, 페이드 인·아웃
-
오디오 병합: 2~10개 오디오 파일을 하나로 병합
-
크로스페이드: 선택 구간 제거 시 0·10·20·50·100ms 전환 효과
-
파형 편집: 파형 시각화, 확대·축소, 구간 선택, 재생 위치 이동 및 반복 재생
-
작업 관리: 비동기 처리, SSE 기반 진행 상태 확인, 작업 취소 및 결과 다운로드
-
사용자 인터페이스: 실행 취소·다시 실행, 한국어·영어·일본어·중국어 지원, 라이트·다크·시스템 테마
※ 기술 스택
Python, FastAPI, Uvicorn, Pydantic, FFmpeg, FFprobe, HTML5, CSS3, Vanilla JavaScript, REST API, SSE
※ 설치 및 운영 환경
-
Linux: Python 가상환경 및 FFmpeg 기반 실행
-
Windows: Python 가상환경 및 작업 스케줄러를 이용한 자동 시작 지원
-
macOS: Intel 및 Apple Silicon 환경을 위한 설치 방법 제공
-
공통: Python 3.11 이상, FFmpeg·FFprobe 필요, Docker 및 별도의 웹·데이터베이스 서버 설치 불필요
개발과 운영에 동일한 FastAPI 애플리케이션과 Uvicorn 실행 구조를 사용합니다.
운영체제별 설치 및 일부 오디오 코덱 호환성은 추가 검증이 필요합니다.
※ 프로젝트 링크
라이선스: MIT License
Audio Toolkit v1.0.0은 첫 공식 공개 버전입니다.
복잡한 서버 환경을 구성하지 않고도 자신의 PC에서 오디오 변환과 편집 기능을 직접 운영할 수 있도록 하는 것이 이 프로젝트의 핵심 목표입니다.
아직 부족한 부분이 있을 수 있지만, 로컬 자체 호스팅과 Python 기반 애플리케이션 개발에 관심 있는 분들께 참고가 되었으면 합니다.
사용 중 발견한 오류나 개선 의견은 GitHub Issues를 통해 자유롭게 남겨주시면 감사하겠습니다.
○ 참고 : 해당 포트폴리오
댓글 1개
Glitter Gim님 예술가시네요.
그림이면 그림, 음악이면 음악, 동영상이면 동영상!!
못하는 분야가 없네요. 대단하십니다.
예전에 mid 음악 파일 가지고 놀던떄가 생각나네요.
방금 들어가서 wma 올리니 애가 놀라네요.ㅋㅋ