SmartTube

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 31,991 Open GitHub ↗

Android TV에서 자신만의 규칙으로 미디어 콘텐츠를 탐색하세요

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[<img src="images/badge_fdroid.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/app.smarttube.fdroid/)
[<img src="images/badge_github.png" alt="Get it on GitHub" height="80">](https://github.com/yuliskov/SmartTube/releases)

# 앱에 대한 중요 공지

제 개발 환경이 출처를 알 수 없는 악성 소프트웨어에 감염되었으며, 그로 인해 일부 빌드가 영향을 받았을 수 있습니다. 문제를 감지한 즉시 전체 디스크 포맷으로 모든 것을 안전하게 조치하고 클린 세팅으로 복원했으며, 이제 모든 빌드는 VirusTotal로 검사됩니다. F-Droid 버전도 출시 전에 검증될 것입니다.

공개 키가 유출되었을 수 있으므로 이 문제를 공유합니다. 새 버전과 새 공개 키는 아래에서 다운로드할 수 있으며, 백업 복원 방법도 함께 제공됩니다.

앱이 **일회용 연결 코드**를 사용하므로 추가 작업은 필요하지 않습니다. 이 코드는 권한이 매우 제한되어 있습니다(예: 비밀번호를 변경할 수 없음). 그래도 완전한 안심을 원하신다면 언제든지 연동을 해제할 수 있습니다.

# 접근 권한 해제 방법:

1. [myaccount.google.com/security](https://myaccount.google.com/security)에 접속합니다.
2. **“서드파티 앱 및 서비스와의 연결”**(Your connections to third-party apps & services)을 찾습니다.
3. **“모든 연결 보기”**(See all connection)를 누르고 **YouTube TV** 또는 **Google Drive**를 찾습니다.
4. 해당 앱 선택 → **“액세스 삭제”**(Remove access)를 누릅니다.

보호를 유지하기 위해 내장된 보안 기능들을 활성화 상태로 유지해 주세요.

# SmartTube

![The app screenshot](https://raw.githubusercontent.com/yuliskov/SmartTube/master/images/browse_home.png)

SmartTube는 Android TV 및 TV 박스를 위한 무료 오픈소스 미디어 클라이언트입니다. TV에 최적화된 인터페이스로 다양한 공개 소스의 콘텐츠를 탐색하고 재생할 수 있습니다.

### ✅ 기능
- 깔끔한 인터페이스 
- SponsorBlock 통합  
- 조절 가능한 재생 속도  
- 8K 해상도 지원  
- 60fps 재생  
- HDR 호환  
- 실라이브 채팅 보기  
- 사용자 지정 가능한 버튼  
- Google 서비스 불필요  
- 유용한 글로벌 커뮤니티

### ❌ 제한 사항
- 스마트폰 및 태블릿 미지원  
- 댓글 기능 불안정  
- 기기에 따라 음성 검색 및 캐스팅 성능이 공식 앱보다 떨어질 수 있음

한 번 사용해 보세요!

**질문이 있으신가요?** 이 리드미에서 먼저 Ctrl+F 또는 ⌘F를 눌러 검색해 보세요!

## 기기 지원
> [!IMPORTANT]  
> 2025년 10부터 신형 Amazon FireTV 기기는 안드로이드를 기본 구동하지 않습니다. SmartTube는 Amazon 자체 VegaOS를 실행하는 Fire Stick 4k Select 및 그 이후 기기와 **호환되지 않습니다**.

![Device support image](https://raw.githubusercontent.com/yuliskov/SmartTube/master/images/new/compatibility.png)
* **지원 기기:** 모든 Android TV 및 TV 박스 (2025년 10월 이전에 출시된 모든 FireTV 기기, NVIDIA Shield 및 Chromecast with Google TV 포함), 안드로이드 4.3(Kitkat)을 탑재한 구형 기기까지 지원.
* **미지원 기기:** 스마트폰, Samsung Tizen, LG webOS, Apple TV 등의 비안드로이드 플랫폼.

## 설치

> [설치 비디오](images/new/zPV0imF.mp4) (참고: 다운로드 URL이 `kutt.to/stn_beta` 또는 `kutt.to/stn_stable`로 변경되었습니다.)

어떠한 **앱스토어**, APK 웹사이트나 블로그에서도 SmartTube를 다운로드**하지 마세요**. 다른 사람들이 업로드한 것이며 악성코드나 광고가 포함되어 있을 수 있습니다. SmartTube는 어떠한 앱스토어에도 공식적으로 게시되지 않습니다.

**베타 버전**(권장)과 **안정 버전(stable)**이 있습니다. 베타 버전은 안정 버전보다 새로운 기능과 버그 수정을 더 빠르게 받아볼 수 있습니다.

다음 방법 중 하나를 사용하여 앱을 설치할 수 있습니다.

- (**가장 쉬움**) Android TV에 [Downloader by AFTVnews](https://www.aftvnews.com/downloader/)를 설치한 후, 앱을 열고 `kutt.to/stn_beta` 또는 `kutt.to/stn_stable`을 입력합니다. 이후 보안 관련 안내 창을 읽고 이해한 뒤 확인합니다. (베타 버전의 경우 [**79015**](https://aftv.news/79015), 안정 버전의 경우 [**28544**](https://aftv.news/28544)를 입력할 수도 있지만, 이 경우 이미 설치되어 있지 않다면 AFTVnews Downloader 브라우저 애드온을 설치하는 추가 단계가 필요합니다.)
- Android TV에 파일 전송 앱을 설치하고, 스마트폰이나 컴퓨터에서 APK를 다운로드한 후 TV로 전송합니다 (예: Google Play 스토어 / Amazon AppStore의 [_Send Files to TV_](https://sendfilestotv.app/)).
- USB 메모리에 APK를 다운로드한 후 TV에 꽂고 Google Play 스토어 / Amazon AppStore의 파일 관리자 앱을 사용합니다 (예: [_FX File Explorer_](https://play.google.com/store/apps/details?id=nextapp.fx) 또는 [_X-plore_](https://play.google.com/store/apps/details?id=com.lonelycatgames.Xplore)). 안드로이드에 기본 설치된 파일 관리자는 작동하지 않습니다! 광고가 가득한 _FileCommander_는 **다운로드하지 마세요**.
- 고급 사용자라면 ADB를 사용하여 설치할 수 있습니다. [가이드](https://fossbytes.com/side-load-apps-android-tv/#h-how-to-sideload-apps-on-your-android-tv-using-adb) | [대체 가이드](https://www.aftvnews.com/sideload/)

**문제 해결:** 아래의 기기별 참고 사항을 확인하세요. 설치가 실패하는 경우, **디스크 공간이 부족**하거나 APK 파일이 올바르게 다운로드되지 않은 것입니다. 공간을 확보하고 다시 다운로드해 보세요. 앱이 설치되었으나 실행 시 강제 종료되는 경우, SD 카드나 외장 스토리지가 아닌 내장 메모리에 설치되었는지 확인하세요.

**앱에는 변경 내역이 포함된 내장 업데이터가 있습니다.** [Telegram 채널 @SmartTubeNewsEN](https://t.me/s/SmartTubeNewsEN)(계정 없이 읽기 가능)이나 [Github](https://github.com/yuliskov/SmartTube/releases/)에서도 모든 릴리스와 **변경 내역**을 확인할 수 있습니다.

> 최신 [**베타 다운로드**](https://github.com/yuliskov/SmartTube/releases/download/latest/smarttube_beta.apk)
>
> 최신 [안정 버전 다운로드](https://github.com/yuliskov/SmartTube/releases/download/latest/smarttube_stable.apk)

### 설치 (Chromecast with Google TV)

**Chromecast with Google TV**에서는 기본적으로 앱 설치가 차단되어 있으므로 추가 단계가 필요합니다.

> **4.1. 개발자 옵션 활성화**
>
> 크롬캐스트에서 사이드 메뉴를 열고 _설정 > 시스템 > 정보_로 이동합니다. _Android TV OS 빌드_ 항목을 찾아서 여러 번 연속으로 클릭합니다. 개발자가 되기까지 몇 단계 남았다는 토스트 메시지가 나타납니다. 개발자 모드가 켜질 때까지 계속 클릭합니다.
>
>
> **4.2. "알 수 없는 출처" 설정 켜기**
>
> 메인 _설정_ 페이지로 돌아와 _앱 > 보안 및 제한 > 알 수 없는 출처_를 선택합니다. \[_Downloader by AFTVnews_ 또는\] 사용하기로 한 파일 브라우저 앱의 토글을 켭니다 [...].
>
> [[소스 및 사진 가이드](https://www.androidpolice.com/2021/02/07/how-to-sideload-any-apk-on-the-chromecast-with-android-tv/#install-the-apk)]

이후 위의 [일반 설치 가이드](#installation)를 따르면 됩니다.

### 설치 (중국 내수용 펌웨어가 탑재된 Xiaomi 기기)

샤오미의 **중국 내수용 펌웨어**는 **베타 버전** 설치를 차단할 수 있습니다. 글로벌 펌웨어는 영향을 받지 않습니다. 해결 방법:
1. 대신 SmartTube **안정 버전** 사용하기(**권장**)
2. 기기를 글로벌 펌웨어로 변경하기
3. (기기가 2020년 이전 모델인 경우) 공장 초기화를 수행한 후, 시스템 업데이트를 진행하기 전에 SmartTube 베타를 설치합니다. 그 후 시스템을 안전하게 업데이트하면 SmartTube가 정상 작동합니다.

### 업데이트

앱에 내장 업데이터가 포함되어 있으므로, 설치 과정은 **한 번만** 거치면 됩니다. SmartTube를 실행한 지 몇 초 지나지 않아 업데이트가 있는 경우 알림과 함께 변경 내역을 보여줍니다. 설정의 "정보"에서 자동 업데이트 확인을 비활성화하거나 수동으로 업데이트할 수 있습니다.

설치에 실패하는 경우, **디스크 공간이 부족**하거나 업데이트가 올바르게 다운로드되지 않은 것입니다. 공간을 확보한 후 다시 업데이트를 시도하세요 (_설정 > 정보 > 업데이트 확인_).

## 호환성

SmartTube에는 Android 4.3 이상이 필요합니다. 비안드로이드 기기(LG 또는 Samsung TV 등)에서는 작동하지 않습니다. 지원되지 않는 TV에서는 TV 스틱이나 TV 박스를 사용할 수 있습니다. 이 앱은 기술적으로 스마트폰과 태블릿에서도 실행되지만, 해당 기기용으로 최적화되어 있지 않으며 공식 지원을 제공하지 않습니다!

다음 기기를 포함하여 안드로이드 기반의 TV, TV 박스, TV 스틱에서 정상 작동 테스트를 마쳤습니다.

- Android TV 및 Google TV (예: Philips, Sony)
- Chromecast with Google TV 및 _Chromecast built-in_이 탑재된 TV
- Amazon FireTV 스틱 (모든 세대)
- NVIDIA Shield
- 안드로이드 기반 TV 박스 (시중의 저렴한 중국산 노브랜드 박스 다수)
- Xiaomi Mi Box

## 기능

### 인터페이스

SmartTube는 미디어 콘텐츠 시청에 방해되지 않는 깔끔한 인터페이스에 중점을 둡니다. 광고 관련 UI 요소가 포함되어 있지 않으며, 탐색 및 재생 경험에 집중합니다.

### SponsorBlock

SmartTube에는 선택적으로 사용할 수 있는 SponsorBlock 기능이 통합되어 있습니다. [SponsorBlock 웹사이트](https://sponsor.ajay.app/)의 설명:

> SponsorBlock은 오픈소스 크라우드소싱 브라우저 확장 프로그램이자 오픈 API로, 유튜브 영상의 **스폰서 구간을 건너뛰는** 데 사용됩니다. [...] 이 확장 프로그램은 개인정보를 보호하는 쿼리 시스템을 사용하여 **알려진** 스폰서를 자동으로 건너뜁니다. 또한 인트로, 아웃트로, 구독 요청 등의 **다른 카테고리** [및 뮤직비디오 내 비음악 파트]도 건너뛰기를 지원합니다.

설정에서 건너뛰고 싶은 카테고리를 선택할 수 있습니다. 브라우저 애드온과 달리, SmartTube에서는 새로운 구간을 직접 제출할 수 없습니다(TV와 TV 리모컨은 이러한 정밀한 조작에 적합하지 않기 때문입니다). SponsorBlock은 사용자의 자발적인 기여를 바탕으로 하는 무료 프로젝트이므로 항상 100% 작동하지는 않을 수 있습니다. 때로는 데이터베이스에 스폰서 구간이 아직 등록되지 않았거나 SponsorBlock 서버가 오프라인 상태이거나 과부하 상태일 수 있습니다.

### 캐스팅

스마트폰(또는 다른 기기)에서 영상을 캐스팅하려면 해당 기기를 TV와 연결해야 합니다. 원본 유튜브 앱과 달리, SmartTube는 동일한 와이파이 네트워크에 있다고 해서 자동으로 나타나지 않습니다. 스마트폰과 TV를 연결하는 방법:

1. SmartTube를 열고 설정으로 이동합니다.
2. "원격 제어"(2번째 옵션)로 이동합니다.
3. 휴대폰에서 유튜브 앱을 열고 설정 > 일반 > TV로 시청으로 이동합니다.
4. _TV 코드로 연결_을 클릭하고 TV에 표시되는 코드를 입력합니다.

[**스크린샷 가이드**](https://t.me/SmartTubeEN/8514)

기술적 한계로 인해 캐스팅 전에 TV에서 앱을 미리 열어두어야 합니다. SmartTube는 TV를 자동으로 깨울 수 없습니다.

### 화면 속 화면 (PiP)

SmartTube는 PiP 모드 영상 재생을 지원합니다. 이 기능은 _설정 > General > 백그라운드 재생 > 화면 속 화면_에서 활성화해야 합니다. 영상을 재생하는 동안 홈 버튼을 누르면 PiP 모드로 전환되며, _설정 > General > 백그라운드 재생(활성화)_에서 설정한 경우 _뒤로 가기_ 버튼을 눌렀을 때도 전환됩니다.

### 속도 조절

플레이어 상단 행에 있는 속도 표시 아이콘(게이지)을 눌러 재생 속도를 조절할 수 있습니다. 이 설정은 영상 간에 유지됩니다. 특정 속도에서는 프레임 드롭이 발생할 수 있으며, 이는 알려진 문제입니다.

### 음성 검색

전역 음성 검색을 활성화하려면 SmartTube 외에 추가 앱을 설치해야 합니다. 이 _브리지 앱_을 사용하면 시스템 음성 검색이 기본 유튜브 앱 대신 SmartTube를 실행할 수 있습니다. 이 기능을 사용하려면 기존 유튜브 앱을 제거해야 합니다. 번거롭게 느껴질 수 있지만, 원할 경우 언제든지 다시 설치할 수 있습니다. _브리지 앱_은 런처에 표시되지 않으며 직접 실행할 수 없고, 시스템 음성 검색 내부에서만 사용됩니다. 일부 기기에서는 검색 시 "유튜브"라는 단어를 명시해야 할 수 있습니다(예: "귀여운 고양이" 대신 "유튜브 귀여운 고양이"라고 말하기).

**Amazon Fire TV의 경우**:

1. 기본 유튜브 앱 제거 (루팅 불필요)
2. Amazon Bridge SmartTube 앱 다운로드 및 설치: https://kutt.to/stn_bridge_amazon (예: _Downloader by AFTVnews_ 사용)

**Google Chromecast with Google TV의 경우**:

1. 기본 유튜브 앱 제거 (루팅 불필요)
2. ATV Bridge SmartTube 앱 다운로드 및 설치: https://kutt.to/stn_bridge_atv (예: _Downloader by AFTVnews_ 사용)

**기타 모든 안드로이드 기기의 경우**, 안타깝게도 이 기능을 활성화하려면 루팅이 필요합니다:

1. 기기 루팅 (특정 기기용 가이드 검색)
2. 루팅 권한을 사용하여 공식 유튜브 앱 제거 (`adb shell pm uninstall com.google.android.youtube.tv`)
3. ATV Bridge SmartTube 앱 다운로드 및 설치: https://kutt.to/stn_bridge_atv (예: _Downloader by AFTVnews_ 사용)

## 후원

제 개발 활동을 지원하고 싶으시다면 커피 한 잔 사주셔도 좋습니다 :)

- [**Patreon (Visa, Mastercard, PayPal)**](https://www.patreon.com/smarttube) 
- **PayPal**: firsthash@gmail.com 
 
- **BTC**: 1JAT5VVWarVBkpVbNDn8UA8HXNdrukuBSx 
- **LTC**: ltc1qgc24eq9jl9cq78qnd5jpqhemkajg9vudwyd8pw 
- **ETH**: 0xe455E21a085ae195a097cd4F456051A9916A5064 
- **ETC**: 0x209eCd33Fa61fA92167595eB3Aea92EE1905c815 
- **TRX**: TJNPY794aSGZf3WGHTna2VCWm2G5Yua7E8 
- **USDT (TRC20)**: TJNPY794aSGZf3WGHTna2VCWm2G5Yua7E8 
- **USDT (BEP20)**: 0x64B28da787BE6ac5889D276A5638d4f077840eC5 
- **USDT (ERC20)**: 0xe455e21a085ae195a097cd4F456051a9916a5064 
- **TON**: UQAc9zgnnzwS8yb5wxAu5CB0RddmjPBjWI-n46oQ7XfCQrgI 
- **XMR**: 48QsMjqfkeW54vkgKyRnjodtYxdmLk6HXfTWPSZoaFPEDpoHDwFUciGCe1QC9VAeGrgGw4PKNAksX9RW7myFqYJQDN5cHGT

## 지원

**먼저 [FAQ](#faq)를 확인해 주세요!** 또한 최근 채팅 기록도 가볍게 살펴봐 주시기 바랍니다.

Telegram 그룹이나 [Github 이슈 트래커](https://github.com/yuliskov/SmartTube/issues)(계정 필요)를 통해 제보하실 수 있습니다.

- **Telegram 그룹 (국제)**: [@SmartTubeEN](http://t.me/SmartTubeEN) 
- **Discord 그룹 (국제)**: [SmartTube Official](https://discord.gg/Wt8HDDej5z) 
- **Telegram group (RU/UA)**: [@SmartTubeUA](http://t.me/SmartTubeUA) 
- **Email**: firsthash@gmail.com

국제 그룹은 **영어로만** 소통합니다. 영어가 완벽하지 않아도 걱정하지 마세요. 친절한 글로벌 커뮤니티가 반겨줄 것입니다.

## 팀

SmartTube는 혼자서 개발하고 있으며, 거대한 팀이나 기업이 뒤에 있지 않습니다. 이 프로젝트는 오픈소스 취미 프로젝트입니다. 여러 다른 분들이 번역을 도와주셨으며, 일부 기여자 목록은 [Github](https://github.com/yuliskov/SmartTube/graphs/contributors)에서 확인할 수 있고, 어떤 분들은 Yurii에게 직접 번역본을 보내주기도 했습니다. 지원 채팅에서도 도움을 주시는 고마운 분들이 많이 계십니다.

## 빌드
    
**참고: OpenJDK 14 이하(!)가 필요합니다. 더 최신 JDK를 사용하면 앱이 강제 종료될 수 있습니다!**  
디버그 버전을 빌드하고 설치하려면 다음 명령어를 실행하세요:

```
git clone https://github.com/yuliskov/SmartTube.git
cd SmartTube
git submodule update --init
adb connect <device_ip_address>
gradlew clean installStstableDebug
```

## 비디오 코덱

비디오 코덱은 비디오 압축에 사용되는 알고리즘입니다.

### 어떤 코덱을 선택해야 할까요 / 개요

| | 권장 사항 | 하드웨어 지원 | 압축률, 비트레이트\* | 화질 |
|:--------:|:---------------------------------------------|:---------------------------- |:----------------------:|:-------:|
| **AV01** (aka. AV1) | 최고 선택, **기기가 지원하는 경우** | **2020년** 출시 기기부터 탑재 시작 | **최고** (예: 1.6 Mbps) | 동일 |
| **VP9** | **대부분의 기기에서 최고의 선택** | **2015년 이후** 출시된 대부분의 기기 | **더 우수함** (예: 2.1 Mbps) | 동일 |
| AVC | 구형 또는 느린 하드웨어 전용 | **모든** 기기 | 양호함 (예: 2.7 Mbps) | 동일 |

\* 예시는 다음 영상의 1080p @ 25fps 비디오 전용 트랙을 기준으로 합니다: [Dua Lipa - New Rules (Official Music Video)](https://youtube.com/watch?v=k2qgadSvNyU)

동일한 해상도에서는 **낮은 비트레이트가 더 좋습니다!** 유튜브는 코덱과 무관하게 명시적으로 **동일한 화질**을 목표로 합니다. 구형 코덱의 비트레이트가 더 높은 이유는 효율성이 떨어지기 때문일 뿐입니다. 유튜브에서는 단순히 더 높은 비트레이트를 선택한다고 해서 화질이 더 좋아지지 **않습니다**. 최신 코덱은 압축률이 더 좋고 = 비트레이트가 낮으며 = 대역폭을 덜 소모하고 = 환경을 보호합니다. 이것은 버그가 아니라 기능입니다. 비효율적인 코덱 대신 기기에서 부드럽게 작동하는 가장 최신 코덱을 사용해야 합니다. AVC는 대개 가장 높은 비트레이트를 가집니다. 이는 좋은 것이 아니라 나쁜 것입니다.

### 어떤 화질을 선택해야 할까요?

현재 대역폭에 따른 자동 모드는 제공되지 않습니다. 하지만 설정 \> 비디오 플레이어 \> 비디오 프리셋에서 기본 비디오 프리셋을 직접 구성할 수 있습니다. 첫 번째 옵션("없음")은 비디오 플레이어 내에서 마지막으로 선택한 설정을 기억합니다. 그 외의 프리셋은 각 비디오 재생 시 초기값으로 사용되며, 선택한 프로필을 사용할 수 없는 경우 그다음으로 가장 좋은 옵션이 사용됩니다. 플레이어 내에서 각 비디오별로 프로필을 개별적으로 재정의할 수도 있습니다.

선택적 해상도 / 비디오 화질을 결정하려면 몇 가지 제한 요소를 고려해야 합니다.
- 대역폭 (대역폭이 처리할 수 있는 비트레이트까지만 선택하세요. 넷플릭스가 제공하는 [fast.com](https://fast.com)을 통해 속도 테스트를 할 수 있습니다)
- TV의 디스플레이 해상도 (720p 디스플레이에서 1080p 같은 한 단계 더 높은 해상도를 선택하면 화질이 **약간 향상될 수** 있지만, 엄청난 차이를 기대하지는 마세요)
- TV의 성능 (예: HDR, 60fps 지원 여부)

일반적으로 60fps는 개선 사항이지만, 차이를 느끼지 못하거나 (상관없다면) 60fps를 선택하지 않음으로써 대역폭(과 환경)을 아낄 수 있습니다.

### HDR

HDR은 **하드웨어가 지원하는 경우에만** 작동합니다. 복잡하게 얽혀 있습니다:
- TV가 지원해야 합니다
- TV 박스를 사용하는 경우, 해당 TV 박스 **및** TV 케이블 **및** TV가 모두 HDR을 지원해야 합니다
- 그렇습니다, 실제로 HDR 지원 여부가 다른 다양한 HDMI 케이블 버전이 존재하며 복잡합니다
- 일부 기기(예: **NVIDIA Shield**)는 일반적으로 HDR을 지원하지만, 유튜브에서 사용되는 특정 HDR 형식은 지원하지 **않습니다** :cry:
 
HDR 영상이 어둡거나 물 빠진 색감으로 보이는 경우, [이 문서](https://www.wired.com/story/hdr-too-dark-how-to-fix-it/)를 확인하세요. **HDR이 작동하지 않는다면**, 아마도 이 앱의 잘못이 아닙니다. 웹에서 "HDR"과 기기 이름을 함께 검색하여 도움을 찾아봐야 할 수 있습니다.

## 면책 조항

당사는 본 도구 또는 제3자가 제공하는 외부 인스턴스의 사용에 대해 어떠한 책임도 지지 않습니다. 거주 국가의 유효한 공식 규정을 준수할 것을 강력히 권장합니다. 나아가, 제3자 서비스의 부적절한 사용에 대해서도 책임을 지지 않습니다.
본 도구는 자유롭고 개방된 소프트웨어의 정신에 따라 제공됩니다.

본 소프트웨어가 제공되는 LICENSE는 [여기](./LICENSE)에서 확인할 수 있습니다.

>   16. 책임 제한.
>
> 관련 법률에 의해 요구되거나 서면으로 동의되지 않는 한, 어떠한 경우에도 저작권자 또는 위에서 허용된 대로 프로그램을 수정 및/또는 배포하는 다른 당사자는 프로그램의 사용 또는 사용 불능으로 인해 발생하는 일반적, 특별적, 부수적 또는 결과적 손해를 포함한 어떠한 손해(데이터 손실, 데이터 부정확성, 사용자나 제3자가 입은 손실, 또는 다른 프로그램과 함께 작동하지 않는 실패를 포함하되 이에 국한되지 않음)에 대하여 귀하에게 책임을 지지 않으며, 이는 그러한 소유자나 다른 당사자가 그러한 손해의 가능성을 통보받은 경우에도 마찬가지입니다.

## FAQ

### Q: 영상 버퍼링이 너무 심합니다

A: NextDNS 같은 암호화된 DNS로 전환해 보세요. 이러한 DNS는 자동으로 설정할 수도 있고 수동으로 설정할 수도 있습니다. 자동 설정을 원하시면 [F-Droid의 Intra apk](https://f-droid.org/en/packages/app.intra/)와 TV가 재시작될 때마다 자동으로 실행되도록 해주는 ["AutoStart - No root"](https://play.google.com/store/apps/details?id=com.autostart) apk를 사용할 수 있습니다. 수동 설정의 경우 [이 가이드를 사용하세요](https://www.reddit.com/r/MiBox/s/7esEVGtAAa).

### Q: 말한 검색어에 대한 결과가 나오지 않습니다 (Android 11)

A: "Android TV용 Google 앱"의 최신 업데이트로 인해 이 버그가 발생한다는 제보가 있습니다. 업데이트를 삭제하면 문제가 해결될 것입니다.

### Q: AV01이 재생되지 않습니다 / 제 기기에서 왜 VP9가 느린가요?

A: AV01은 매우 최신 기술이기 때문에, **대부분의** TV와 TV 박스가 하드웨어 지원을 제공하지 않으며 AV01을 **전혀** 재생할 수 없습니다.

기기가 코덱에 대한 하드웨어 가속을 지원하는 경우, 해당 코덱을 사용하는 영상이 부드럽게 재생되어야 합니다. 4k를 공식적으로 지원하지 않는 저렴한 TV 박스에서는 VP9를 사용할 때 고해상도 영상이 느릴 수도 있습니다. 하드웨어 가속 없이도 기기가 VP9 영상을 재생할 수 있겠지만, 원활하게 실행되려면 강력한 CPU가 필요합니다. 하드웨어 가속 없이 AV01을 수정하는 것은 기술적으로 가능하지만 현재 계획에 없으며 효율적이지도 않을 것입니다.

### Q: SmartTube를 원본 앱처럼 보이게 만들 수 있나요?

A: SmartTube의 UI에 비해 스톡 유튜브와 YT Kids가 훨씬 앞서 있습니다. 하지만 이를 구현할 기술이 있고 충분한 시간과 에너지를 쏟을 의향이 있는 사람이 필요합니다. 또한 장기적으로 유지보수(새로운 기능, 버그 수정 포함)를 해야 합니다. 이 모든 것이 무료로 말이죠. 만약 그런 사람이 있다면 도와주세요.
SmartTube가 Android TV 앱에 대한 구글의 공식 템플릿과 권장 사항을 따르고 있다는 점도 언급해야겠군요. 템플릿이 다소 투박한 것은 구글 탓입니다. 😂

### Q: 검색 페이지를 개선할 수 있나요?

A: 개선할 수 있지만, 위 FAQ 항목과 마찬가지로 누군가가 작업을 수행해야 합니다. SmartTube는 TV 앱에 대해 구글이 공식 권장하는 디자인/템플릿을 따르고 있으며, 구글이 공식 선탑재한 Android TV 키보드를 사용하고 있습니다. 안타깝게도 구글은 검색 페이지와 키보드 측면에서 정말 형편없는 작업을 해놓았습니다. 향후 SmartTube 업데이트를 통해 원본 유튜브나 기타 주요 Android TV 앱처럼 내장 키보드가 추가될 수도 있습니다. 공식 유튜브 앱만큼 혹은 그 이상으로 외관이 개선될 수도 있겠죠. 하지만 현재로서는 시간 부족과 구글의 공식 권장 사항이 부실한 탓에 이 상태로 유지되고 있습니다.

### Q: Samsung Tizen TV / LG webOS TV / Roku / iOS / 토스터에 설치할 수 있나요?

A: 아닙니다. 이 앱은 **Android** 기기에서만 작동합니다. Android TV 제품 페이지를 보면 대개 안드로이드 기반임이 명시되어 있습니다. 이 앱은 다른 플랫폼으로 쉽게 포팅될 수 없으며, 시도할 계획조차 없습니다. **묻지 말아 주세요**. 대신 TV에 별도의 TV 스틱이나 TV 박스를 연결하여 사용하시기 바랍니다.

### Q: 스마트폰에 설치할 수 있나요? / 세로 모드를 추가해 주실 수 있나요? / 스크롤이 작동하지 않습니다.

A: **절대 안 됩니다**. 이 앱은 스마트폰용이 **아니며**, 스마트폰에 대해서는 **어떠한 지원도 제공하지 않습니다**.

다만 스마트폰에서 SmartTube가 실행 중인 TV / TV 박스로 영상을 **캐스팅할 수는 있습니다**. 공식 유튜브 앱, [Morphe](https://github.com/MorpheApp) 또는 [ReVanced](https://github.com/ReVanced)를 사용하시고, 자세한 내용은 [캐스팅 섹션](#casting)을 참고하세요.

**스마트폰 버전은 출시되지 않습니다.** 대신 [Morphe](https://github.com/MorpheApp), [ReVanced](https://github.com/ReVanced), [Pure Tuber](https://play.google.com/store/apps/details?id=free.tube.premium.advanced.tuber), [LibreTube](https://github.com/libre-tube/LibreTube), [NewPipe](https://newpipe.schabi.org) 또는 [NewPipe x SponsorBlock](https://github.com/polymorphicshade/NewPipe#newpipe-x-sponsorblock)을 사용할 수 있습니다. 도움이 필요하시면 해당 앱들의 지원 채팅을 이용해 주세요.

### Q: 태블릿 / 자동차 화면 / 도킹 스테이션이 있는 스마트폰에 설치할 수 있나요?

네... 아마도요.. 요구 사항:

- 안드로이드 기기여야 함
- 대화면이어야 함
- TV 리모컨, 게임 패드 또는 키보드가 있어야 함
  **터치 입력은 지원되지 않습니다.** 마우스/터치패드 스크롤도 지원되지 않습니다. 오직 터치나 마우스 입력만으로는 SmartTube를 제대로 사용할 수 없습니다.

일부 사용자는 ([차량용 엔터테인먼트 시스템](https://t.me/SmartTubeEN/6060)을 포함해) 큰 성공을 거두었다고 보고했습니다. **여러분의 성공 사례도 저희에게 공유해 주세요.**

### Q: "알 수 없는 코덱" / "동영상을 다운로드할 수 없음" 오류가 발생합니다

A: 동영상이 재생될 때까지 5초 정도 기다려 보세요. 그래도 해결되지 않으면 재생 버튼을 누르세요. USB 오디오 기기가 연결되어 있거나 디스크 저장 공간이 가득 찼을 때만 이 문제가 발생한다는 사용자 보고가 있습니다.

### Q: "비디오 프로필이 지원되지 않습니다" 오류가 발생합니다

A. 좌측 하단의 "HQ" 버튼을 누르고, _비디오 형식(video formats)_을 선택한 뒤 AV01 외의 다른 것을 선택하세요. AV01은 대부분의 기기에서(귀하의 기기를 포함하여 명백히) **지원되지 않으므로**, 대신 VP9를 선택하세요. 자세한 내용은 [비디오 코덱 섹션](#Video-codecs)을 참고하세요.

### Q: 미등록 영상이나 내 영상을 시청할 때 "동영상 재생 불가"가 뜹니다

A: 맞습니다, 현재 버그입니다.

### Q: 캐스팅 목록에 나타나지 않습니다

A: [캐스팅](#casting) 섹션을 읽어 주세요.

### Q: "로그인하여 봇이 아님을 확인하세요"라는 오류가 뜹니다

A: 계정에 로그인하지 않은 경우, 유튜브에서 귀하의 IP 주소 대역을 일시적/영구적으로 동영상 시청 차단했을 수 있습니다.

### Q: 비디오 버퍼링이 너무 심합니다

A: 다른 비도표시 비공식 유튜브 앱에서도 이 문제가 보고되는 것으로 보아, SmartTube만의 문제가 아닐 수 있습니다. 요즘에는 드문 일이지만 2021년 2분기에는 매우 빈번했습니다. 일부 사용자나 기기가 다른 기기에 비해 더 큰 영향을 받는 것으로 보입니다. 공식 유튜브 앱과 웹사이트는 이 문제의 영향을 거의 받지 않는 것으로 보입니다. 문제의 근본 원인은 현재 불분명하지만 유튜브 측의 서버단 문제인 것으로 보입니다. 어쩌면 유튜브가 서드파티 앱을 차별하고 있는 것일지도 모릅니다.

일단 다음 방법들이 도움이 되는지 확인해 보세요:

- 해상도를 낮추기 (또는 다시 원래대로 변경)
- 비디오 형식을 AVC로 변경
- 설정에서 버퍼 늘리기
- 뒤로 가기 버튼을 누르고 동영상을 다시 재생해 보기

### Q: 디버그 정보에는 디스플레이가 1080p라고 나오는데, 저는 4k/UHD 디스플레이를 사용 중입니다!

A: 걱정하지 마세요, **디버그 정보가 잘못된 것입니다.** SmartTube는 1080p를 초과하는 해상도에서도 잘 작동하며, 4k 또는 UHD로 영상을 재생해 보면 이를 직접 확인할 수 있습니다.
또한 디스플레이가 1080p인데 "720p"라고 표시되더라도 걱정하지 마세요.

### Q: 왜 최고 화질이 자동으로 선택되지 않나요?

A: (**기본적으로**) **작동합니다.** 설정에서 _비디오 프로필_을 설정한 경우, 그것이 자동 선택의 상한선 역할을 합니다. 비디오 프로필이 설정되어 있는지 확인하고, "없음"을 선택하여 해제할 수 있습니다.

**화질과 비트레이트를 혼동하지 마세요**. 자세한 내용은 [비디오 코덱 섹션](#Video-codecs)을 참고하세요.

### Q: 기본 (최대) 해상도를 설정할 수 있나요?

A: SmartTube는 설정의 "비디오 프로필"에서 설정할 수 있는 최대 해상도까지, 동영상에서 사용 가능한 가장 높은 화질을 자동으로 선택합니다. 가능한 경우 SmartTube는 선택한 비디오 프로필을 선택하고, 그렇지 않으면 그 다음으로 가장 좋은 사용 가능한 옵션을 사용합니다. 영상을 시청하는 동안 언제든지 비디오 프로필을 변경할 수 있습니다.

### Q: 사용 가능한 대역폭에 따라 해상도를 "자동"으로 설정할 수 있나요?

A: 계획은 있지만 아직 제공되지 않습니다(죄송합니다 🙇‍♀️). 하지만 대역폭에 맞게 작동할 만한 수준으로 최대 해상도를 설정할 수 있습니다. 자세한 내용은 위를 참고하세요.

### Q: 비디오 구간이 왜 건너뛰어지나요?

A: SmartTube에는 **SponsorBlock**이라는 기능이 있습니다. 건너뛸 카테고리가 있는 경우 이를 선택할 수 있습니다. 자세한 내용은 [SponsorBlock 섹션](#sponsorblock)을 참고하세요.

### Q: 다음 영상을 자동으로 시작하기 / 모든 영상 재생 후 멈추기

A: 반복 버튼 🔁을 사용하여 다양한 자동 재생 모드 간에 전환할 수 있습니다.

[![반복 버튼을 보여주는 스크린샷](https://raw.githubusercontent.com/yuliskov/SmartTube/master/images/new/V3GHGvWprmdE1w.jpg)](https://t.me/SmartTubeEN/24953)

### Q: 나와 관련 없는 추천 동영상(예: 뉴스)을 없애는 방법은 무엇인가요?

A: 추천 동영상은 앱이 아니라 유튜브가 정의하는 것이므로 알고리즘을 변경할 수 없습니다. 추천은 설정에서 변경할 수 있는 국가를 기반으로 합니다. 로그인한 경우, 시청 기록, 사용자 프로필 데이터 및 구글이 사용할 수 있는 기타 정보를 기반으로 합니다. 로그인하지 않은 경우 "시크릿 모드"와 같으므로 시청 기록이 추천에 영향을 미치지 않습니다. 향후 버전에서는 로그인 없이도 선택적 사용자 프로필 기능을 추가할 수도 있습니다.

### Q: HDR이 작동하나요?

A: 네, **하드웨어가 지원하는 경우** HDR이 작동합니다. **NVIDIA Shield**는 지원하지 않습니다. 자세한 내용은 [HDR 섹션](#HDR)을 참고하세요.

### Q: 일부 업데이트의 변경 내역에 "현재 버전에 만족한다면 업데이트하지 마세요"라고 적혀 있는 이유는 무엇인가요?

A: 이러한 업데이트는 일부 사용자/기기 조치에만 영향을 미치는 버그를 수정하기 위해 많은 코드를 변경합니다. 영향을 받는 페이지만 업데이트해야 합니다. 그 외의 사용자에게는 업데이트로 얻을 수 있는 이점이 없으며, 오히려 새로운 버그가 발생할 가능성이 있습니다. 이미 업데이트했더라도 걱정하지 마세요.

### Q: 다른 속도로 재생할 때 프레임이 건너뛰어집니다!

A: 현재 이 문제를 해결할 수 없습니다. 죄송합니다.

### Q: AFR이 무엇인가요?

A: "Auto Frame Rate(자동 프레임 레이트)"입니다. 시청 중인 콘텐츠에 맞게 TV의 주사율을 조절해 줍니다. 부드러움이 약간 향상될 수 있지만 그 차이는 매우 미미하며, 대부분의 사람들은 거의 눈치채지 못합니다. 모든 하드웨어에서 잘 작동하는 것은 아닙니다. 이게 무엇을 하는지 모르고 직접 테스트해 보고 싶지 않다면 그냥 꺼두어도 무방합니다.

**권장 사항:** 기기에서 작동하는지 확인하기 위해 켜볼 수 있습니다. 문제가 발생하거나 테스트할 필요를 느끼지 않는다면 **끄세요**.

### Q: 높은 버퍼와 낮은 버퍼 중 어느 것을 선택해야 하나요?

A: 버퍼가 높을수록 현재 재생 위치보다 앞서 미리 로드되는 동영상 분량이 많아집니다. 영상이 끝나기 전에 자주 닫는 경우, 낮은 버퍼는 대역폭 사용량을 최소한으로 줄여줄 수 있습니다. 높은 버퍼는 네트워크 문제를 완화하고 버퍼링을 위해 동영상이 일시 정지되는 것을 방지할 수 있습니다. 버퍼가 높을수록 RAM 사용량이 증가하지만, 이는 문제가 되지 않을 것입니다.

**권장 사항: 높음**.

### Q: 뒤로 감기할 때 버퍼가 유지되나요?

A: 아니요, 뒤로 감기할 때(예: 5초 뒤로 건너뛰기) SmartTube는 버퍼링을 다시 해야 합니다. 이 부분은 향후 업데이트에서 개선될 수 있습니다.

### Q: 유튜브를 시청할 때 기기가 멈춥니다

A: 펌웨어 또는 안드로이드 문제일 수 있습니다. 커스텀 롬을 사용 중이라면 해당 롬에 버그가 있을 수 있습니다. 개발자가 이 문제를 디버깅하는 것이 거의 불가능하므로 도와드릴 수 없습니다. 죄송합니다. 재부팅, 캐시 지우기, 앱 재설치, 기기 공장 초기화 같은 일반적인 임시 조치를 시도해 볼 수 있습니다.

### Q: 영상을 다운로드할 수 있나요?

A: SmartTube로는 불가능합니다.

### Q: 업데이트를 자동으로 설치할 수 있나요?

A: 아니요, 기술적으로 불가능합니다. 사전 설치된 앱 관리자(일반적으로 Google PlayStore, Amazon AppStore 등)만 필요한 권한을 가지고 있습니다. SmartTube를 포함한 다른 모든 앱은 열린 설치 프롬프트만 표시할 수 있습니다. 루팅을 이용한 우회 방식이 가능할 수도 있지만 아직 구현되지 않았습니다.

### Q: 특정 채널의 광고를 화이트리스트에 추가할 수 있나요?

A: 아니요, 불가능합니다. SmartTube에는 광고를 표시하는 코드가 전혀 없습니다. 이 기능을 추가하는 것은 실제로 시간과 노력이 소요되며, 그 시간과 노력은 유용한 기능을 추가하고 버그를 수정하는 데 사용되고 있습니다.

SmartTube

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README