624 words
3 minutes
Using AList on Apple TV

Prerequisites#

Apple TV LAN IP: 192.168.2.2

Docker host LAN IP: 192.168.2.3

The Basics#

I’m using a third-party token, which requires the Aliyun Drive third-party access membership — otherwise throughput gets capped at 5 Mbps.

What This Is#

AList is a file-listing program that supports multiple storage backends, web browsing, and WebDAV, built on gin and SolidJS.

Since you can’t install AList directly on an Apple TV, AListServer is used to host the AList service.

AListServer is an AList client on the Apple App Store that makes it easy to run the service and comes with a visual management interface.

Installation#

  1. On the Apple TV, open the App Store, search for AListServer, and install it.
  2. Once installed, open AListServer and start the service.

Configuration#

TIP

If your devices are on the same LAN, you can reach the AList service by pointing a browser at the IP and port of the device running AListServer.

If they’re not, forward AListServer’s port to the public internet via port forwarding, and you can access the service from outside.

  1. Open the AList configuration page in a browser at http://192.168.2.2:5244/
  2. Enter your AList credentials and log in
  3. Go to Storage -> Add -> Aliyun Drive Open — I’ll use Aliyun Drive as the example here; other cloud drives follow the same pattern
  4. Fill in these fields: Mount Path, Drive Type, Root Folder ID, Refresh Token, OAuth Token URL, and Deletion Method. For more details see AList Aliyun Drive Open configuration
    • Mount Path: the entry point for this storage in AList, pick anything you like, e.g. /ali
    • Drive Type: backup drive or resource drive — I picked resource drive
    • Root Folder ID: defaults to root to show the whole drive. To show only one folder, set it to that folder’s file_id: open the folder in the Aliyun Drive web app and grab the last segment of the URL, e.g. 5fe01e1830601baf774e4827a9fb8fb2b5bf7940 from https://www.alipan.com/drive/folder/5fe01e1830601baf774e4827a9fb8fb2b5bf7940
    • Refresh Token: your Aliyun Drive refresh token, obtainable at https://alist.nn.ci/tool/aliyundrive/request.html
    • OAuth Token URL: https://api-cf.nn.ci/alist/ali_open/token or https://api.xhofe.top/alist/ali_open/token
    • Deletion Method: trash or permanent delete, choose as you like
  5. Click Save

Usage#

Visit http://192.168.2.2:5244/ in a browser and you’ll see the file listing from your Aliyun Drive.

Going Further#

Aliyun Drive doesn’t throttle its own TV client, so you can grab the TV client’s token and mount the drive without speed limits.

A quick rant

As a beta user of Aliyun Drive, and later a paying customer, watching them throttle third-party access and roll out “third-party access packs” leaves a sour taste.

Especially the access packs. After I paid for SVIP, WebDAV worked at full speed. Then the third-party access pack launched, and WebDAV got throttled again even for existing SVIP subscribers (yes, there’s a 10GB unthrottled quota, but it feels like a cash grab to me).

profile

Getting the Aliyun Drive TV Token#

Use the Docker project alipan-tv-auth to obtain the TV client’s Refresh Token.

  1. Install alipan-tv-auth via docker-compose
    version: '3.8'
    services:
    alipan-tv-auth:
    image: 'vscodev/alipan-tv-auth:latest'
    container_name: alipan-tv-auth
    ports:
    - '5245:5245'
    restart: unless-stopped
  2. Visit http://192.168.2.3:5245/ in a browser and authorize to get the TV client’s Refresh Token
  3. Paste the Refresh Token into AList’s refresh-token field
  4. Point AList’s OAuth Token URL at http://192.168.2.3:5245/api/oauth/alipan/token
  5. Save, and your Aliyun Drive is now mounted without throttling

Mounting from Third-Party Apps#

You can mount the AList service over WebDAV from apps like Infuse, Forward, or Vidhub.

Here’s Infuse as the example, with AList at http://192.168.2.2:5244/

  1. Open Infuse, then Settings -> Add File Source -> Add -> Add WebDAV
  2. Fill in the fields: protocol, address, username, password, and under Advanced, path and port
    • Protocol: WebDAV or WebDAV (HTTPS)
    • Address: 192.168.2.2
    • Username: admin
    • Password: ***
    • Path: /dav
    • Port: 5244
  3. Click Save
  4. Open the Files tab in the bottom bar and you’ll see the newly added source.
TIP

I didn’t see any scraped metadata for my sources on the home screen, so I’m not sure whether Infuse scrapes WebDAV sources at all.

Forward, the app I use most, scrapes just fine.

Speed Test#

Open one of your shared sources, tap the edit icon on the right, and run a speed test — the average lands around 200 Mbps.

Infuse speed test

Using AList on Apple TV
https://www.mihouo.com/en/posts/apple-tv/using-alist-on-apple-tv/
Author
Jia
Published at
2024-12-31
License
CC BY-NC-SA 4.0