TMPlayer

홈설치 방법

설치 방법, 어디서 보든

TV, 휴대폰, Windows, Linux에서요. 한 번만 하면 돼요.

먼저 파일 받기 전체 INSTALL.md

Android TV 또는 휴대폰: 네 단계

스토어 밖의 앱은 모두 이렇게 Android 기기에 설치해요.

  1. 스토어 밖의 앱 허용

    TV에서는 설정, 기기 환경설정, 정보를 차례로 열고 빌드를 일곱 번 누르세요. 파일을 옮기는 앱에 대해 알 수 없는 출처를 켜세요.

    휴대폰에서는 아직 할 일이 없어요. 파일을 처음 열 때 Android가 물어봐요.

  2. 기기로 파일 옮기기

    휴대폰에서는 APK를 다운로드하고 여세요. TV에서는 무료 Downloader나 Send files to TV 앱을 쓰거나, 같은 Wi-Fi에서 adb를 쓰세요.

    adb connect <tv-ip>:5555
adb install TMPlayer-<version>-universal.apk

    먼저 개발자 옵션에서 네트워크 디버깅을 켜세요.

    Fire TV는 메뉴 이름이 달라요. Fire TV 가이드를 따라 하세요.

  3. 로그인

    TV에서는 QR 코드를 스캔하세요. 휴대폰의 Telegram에서 설정, 기기, 데스크톱 기기 연결를 차례로 열어요.

    휴대폰에서는 대신 전화번호를 입력하세요. 다른 휴대폰의 계정이라면 QR 코드도 여전히 쓸 수 있어요.

  4. 채팅을 고르고 재생을 누르세요

    채팅을 열면 재생 가능한 동영상이 격자로 나와요. 하나를 고르면 몇 초 안에 시작해요.

INSTALL.md 모든 단계와 조작법, 문제 해결 방법이 자세히 나와 있어요.

Windows에서

Windows 10 또는 11, 64비트예요. 관리자 암호가 필요 없어요.

  1. 설치 파일 받기

    다운로드 페이지에서 TMPlayer-<version>-windows-x64.msi를 받으세요. 포터블 zip은 더 이상 배포하지 않아요. 쓰고 있었다면 그 폴더를 지우고 MSI를 설치하세요. 로그인과 설정은 그 폴더가 아니라 사용자 프로필에 있어서 그대로 이어져요.

  2. SmartScreen 넘기기

    이 빌드는 아직 서명되지 않아서 Windows가 Windows가 PC를 보호했습니다라고 알려 줘요. 추가 정보를 누른 다음 실행를 누르세요.

  3. 설치하고 열기

    설치 마법사를 따라 진행하세요. TMPlayer가 시작 메뉴와 바탕 화면에 추가돼요. 더 새로운 MSI를 설치하면 그 자리에서 업그레이드돼요.

  4. QR 코드로 로그인

    휴대폰의 Telegram으로 QR 코드를 스캔하세요. 설정, 기기, 데스크톱 기기 연결 순서예요. 또는 전화번호로 로그인를 고르세요.

Linux에서

64비트 x86, glibc 2.38 이상: Ubuntu 24.04, Debian 13, Fedora 39 이후예요. 그런 다음 QR 코드로 로그인하세요.

모든 배포판에서 AppImage

chmod +x TMPlayer-<version>-x86_64.AppImage
./TMPlayer-<version>-x86_64.AppImage

또는 파일 속성에서 프로그램으로 실행 허용를 체크하고 더블클릭하세요.

Arch Linux

desktop/packaging/aur의 레시피로 makepkg -si를 실행해 패키지를 빌드하거나, AppImage를 쓰세요.

deb, rpm, Flatpak에서 옮겨 올 때

이 형식은 더 이상 배포하지 않아요. 기존 것(sudo apt remove tmplayer, sudo dnf remove tmplayer, flatpak uninstall io.github.dracu_lah.TMPlayer)을 지우고 AppImage를 받으세요. deb나 rpm에서는 로그인과 설정이 그대로 이어져요. Flatpak은 샌드박스 안에 보관했으니 먼저 복사해 두거나 다시 로그인하세요.

Arch 패키지는 메뉴 항목을 알아서 추가해요. AppImage는 아래를 보세요.

바탕 화면, 메뉴, 작업 표시줄에

한 번 클릭으로 열 수 있게 두는 방법이에요.

Windows

MSI 설치: 이미 시작 메뉴와 바탕 화면에 있어요. 고정하려면 시작에서 마우스 오른쪽 버튼으로 클릭하고 작업 표시줄에 고정를 고르세요.

Linux: Arch 패키지

설치하면 바로 앱 메뉴의 멀티미디어 또는 소리 및 비디오에 나타나요.

GNOME: 활동에서 마우스 오른쪽 버튼으로 클릭하고 Dash에 고정를 고르세요. KDE Plasma: 런처에서 마우스 오른쪽 버튼으로 클릭하고 작업 관리자에 고정를 고르세요.

Linux: AppImage를 앱 메뉴에

파일 하나만으로는 메뉴 항목이 없으니 직접 만들어야 해요. 아래 명령어가 AppImage를 제자리로 옮기고, 아이콘을 받고, 런처를 만들어 줘요.

mkdir -p ~/Applications ~/.local/share/icons ~/.local/share/applications
mv ~/Downloads/TMPlayer-<version>-x86_64.AppImage ~/Applications/TMPlayer.AppImage
chmod +x ~/Applications/TMPlayer.AppImage
curl -Lo ~/.local/share/icons/tmplayer.png https://tmplayer.org/icon-512.png

cat > ~/.local/share/applications/tmplayer.desktop <<EOF
[Desktop Entry]
Type=Application
Name=TMPlayer
Comment=Telegram media player
Exec=$HOME/Applications/TMPlayer.AppImage
Icon=$HOME/.local/share/icons/tmplayer.png
Categories=AudioVideo;Video;Player;
Terminal=false
StartupWMClass=com-tmplayer-desktop-MainKt
EOF

chmod +x ~/.local/share/applications/tmplayer.desktop
update-desktop-database ~/.local/share/applications

그다음 위와 같이 고정하세요.

클릭이 편한가요? Gear Lever와 AppImageLauncher가 이 모든 걸 대신해 줘요.

Linux: 바탕 화면 아이콘

위에서 만든 런처를 바탕 화면에 복사하고 신뢰하도록 표시하세요.

cp ~/.local/share/applications/tmplayer.desktop ~/Desktop/
chmod +x ~/Desktop/tmplayer.desktop
gio set ~/Desktop/tmplayer.desktop metadata::trusted true

Arch 패키지는 대신 그 런처를 복사하세요: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME에는 Desktop Icons NG 확장과 한 번의 실행 허용가 필요해요. KDE Plasma는 한 번 물어보고, Xfce와 Cinnamon은 신뢰 표시를 읽어요.

잘 안 될 때

막힌 설치 대부분의 해결 방법이에요.

TV에서 앱이 차단됐다고 하거나 설치 버튼이 반응하지 않아요

알 수 없는 출처는 앱마다 설정해요. TMPlayer가 아니라 Downloader나 Send files to TV에 대해 켠 다음 파일을 다시 여세요.

adb connect가 연결을 거부해요

네트워크 디버깅을 켜고, 두 기기를 같은 네트워크에 연결하고, TV 화면의 신뢰 확인을 수락하세요.

멀리서는 QR 코드가 스캔되지 않아요

가까이 다가가서 휴대폰을 화면과 나란하게 드세요. 카메라 앱이 아니라 Telegram의 설정, 기기, 데스크톱 기기 연결에서 스캔하세요.

Windows에 실행 버튼이 안 보여요

먼저 추가 정보를 누르세요. 회사 컴퓨터는 정책상 서명되지 않은 앱을 막을 수 있어요.

AppImage를 열어도 아무 일도 안 일어나요

대개 FUSE가 없어서예요. libfuse2t64(Ubuntu 24.04 이상) 또는 libfuse2(22.04)를 설치하거나, ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run로 FUSE 없이 실행하세요.

타일링 창 관리자에서 창이 비어 있거나 회색이에요

sway, i3, Hyprland 등에서는 _JAVA_AWT_WM_NONREPARENTING=1를 설정하고 실행하세요.

아직도 막혔나요? 기기, 버전, 화면에 나온 메시지와 함께 이슈를 열어 주세요.

도움이 됐다면 별을 눌러 주세요

이 방법으로 동영상이 화면에 나왔다면, 별을 눌러 다음 사람이 찾는 데 도움을 주세요.

GitHub에서 별 누르기 저장소 포크하기

GPL-3.0, 그리고 영원히 무료