feat: release TypeType 1.3.0

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
     if: github.event_name == 'pull_request'
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v6.0.2
+      - uses: actions/checkout@v7.0.1
         with:
           submodules: true
       - run: ./scripts/validate-stack.sh
@@ -28,7 +28,7 @@ jobs:
     if: github.event_name != 'pull_request'
     runs-on: [self-hosted, Linux, X64, arko, typetype]
     steps:
-      - uses: actions/checkout@v6.0.2
+      - uses: actions/checkout@v7.0.1
         with:
           submodules: true
       - run: ./scripts/validate-stack.sh

.github/workflows/component-image.yml

@@ -127,11 +127,17 @@ jobs:
 
       - name: Update beta
         env:
+          COMPONENT: ${{ needs.validate.outputs.component }}
           DEPLOY_HOST: ${{ secrets.TYPE_TYPE_DEPLOY_HOST }}
           DEPLOY_PORT: ${{ secrets.TYPE_TYPE_DEPLOY_PORT }}
           DEPLOY_USER: ${{ secrets.TYPE_TYPE_DEPLOY_USER }}
+          DIGEST: ${{ needs.validate.outputs.digest }}
+          IMAGE: ${{ needs.validate.outputs.image }}
         run: |
-          ssh -i "$RUNNER_TEMP/typetype_deploy_key" -p "$DEPLOY_PORT" -o BatchMode=yes -o IdentitiesOnly=yes -o StrictHostKeyChecking=yes -o UserKnownHostsFile="$RUNNER_TEMP/known_hosts" "$DEPLOY_USER@$DEPLOY_HOST" /usr/local/sbin/typetype-beta-update
+          printf -v update_command \
+            'TYPETYPE_DEPLOY_COMPONENT=%q TYPETYPE_DEPLOY_IMAGE=%q TYPETYPE_DEPLOY_DIGEST=%q /usr/local/sbin/typetype-beta-update' \
+            "$COMPONENT" "$IMAGE" "$DIGEST"
+          ssh -i "$RUNNER_TEMP/typetype_deploy_key" -p "$DEPLOY_PORT" -o BatchMode=yes -o IdentitiesOnly=yes -o StrictHostKeyChecking=yes -o UserKnownHostsFile="$RUNNER_TEMP/known_hosts" "$DEPLOY_USER@$DEPLOY_HOST" "$update_command"
           curl --fail --retry 12 --retry-delay 2 --retry-all-errors --silent --show-error https://beta.typetype.video/api/health
           curl --fail --retry 12 --retry-delay 2 --retry-all-errors --silent --show-error https://beta.typetype.video/api/downloader/health
 

.gitignore

@@ -6,3 +6,4 @@ tmp/
 .DS_Store
 *.tsbuildinfo
 .env
+.runtime/

RELEASE_NOTES.md

@@ -1,17 +1,98 @@
-# TypeType 1.2.4
+# TypeType 1.3.0
 
-## Summary
+TypeType 1.3.0 brings new backup and content controls, makes SABR the only
+YouTube playback path on the web, and improves downloads and self-hosted
+updates.
 
-- fix intermittent SABR startup failures when resuming videos from a saved position
-- restore reliable audio and video initialization on cold playback sessions
-- prevent stalled preparation from retrying indefinitely
-- improve recovery when a SABR session cannot produce media
-- keep repeated long-distance seeks responsive while SABR recovery is pending
+## Playback
 
-Normal seeks and quality changes continue to preserve the current playback position.
+- Use SABR/MSE for all YouTube web playback, including watch pages, embeds and
+  autoplay. The old Classic toggle and transition prompt have been removed.
+  NicoNico and BiliBili playback remain unchanged.
+  [#168](https://github.com/TypeType-Video/TypeType/issues/168)
+- Recover SABR sessions when YouTube authorization expires and stop stalled
+  preparation attempts instead of retrying indefinitely.
+- Apply automatic SponsorBlock skips in audio-only mode.
+  [#178](https://github.com/TypeType-Video/TypeType/issues/178)
+- Add a default playback speed from `0.25x` to `4x`, applied to regular videos
+  and Shorts.
 
-No configuration or database migration is required.
+## Backups And Content Controls
 
-Thx to everyone who reported playback and buffering issues.
+- Export a complete TypeType backup or select individual categories, including
+  subscriptions, history, playlists, watch later, favorites, playback
+  progress, search history, saved playlists, settings and content filters.
+- Restore versioned TypeType JSON backups with an immediate confirmation
+  showing how many items were restored.
+- Add blocked title keywords to filter unwanted videos from recommendations.
+- Support very large history exports without exceeding PostgreSQL query
+  limits.
+- Preserve more original dates and metadata when importing YouTube Takeout
+  favorites, history and playlists.
 
-If u want to support TypeType, please share it with others. If u want to support it financially, u can do so through [GitHub Sponsors](https://github.com/sponsors/Priveetee).
+## Subscriptions
+
+- Keep subscription feeds updating when one subscribed channel is deleted,
+  private or temporarily unavailable.
+  [#180](https://github.com/TypeType-Video/TypeType/issues/180)
+- Keep live videos ordered by their actual promotion time instead of
+  permanently placing every active live stream first.
+
+## Downloads And Performance
+
+- Rework SABR downloads around bounded multipart streams and concurrent range
+  workers.
+- Reserve the required disk space before starting large downloads to prevent
+  active jobs from exhausting storage.
+- Detect stalled streams while allowing long downloads to continue as long as
+  data is still arriving.
+- Reduce progress-update contention and reuse download buffers.
+- Serve precompressed frontend assets through Nginx.
+
+## Self-Hosting
+
+- Bundle the default Nginx configuration directly in the Frontend image.
+- Generate the default Garage configuration inside a managed Docker volume.
+- Back up existing stack files and preserve custom Compose and Garage
+  configuration during updates.
+- Validate the resolved Compose configuration, wait for service health and
+  provide a rollback directory when an update fails.
+- Show the Frontend, Server, Token and Downloader versions, revisions and build
+  times directly in Settings.
+- Expand the self-hosting documentation with resource requirements and new
+  French and Spanish prerequisites guides.
+  [#176](https://github.com/TypeType-Video/TypeType/issues/176)
+
+Self-hosters should follow the official update procedure for this release
+because the Compose stack and managed configuration have changed.
+
+## Thx
+
+A big thx to @BuggyPasta for the detailed testing and for the ideas behind
+backups, blocked keywords and default playback speed.
+
+Thx to @Toastienergy for reporting the missing SponsorBlock behavior in
+audio-only mode, and to @tam1m for the precise subscription-feed report.
+
+Thx to @jerkiz and @coral-hungus for testing playback and SponsorBlock on real
+iPhones.
+
+Thx to @arcoast for the Nginx, Garage and update-flow suggestions, to
+@filippobaroni for helping expose problems caused by stale self-hosted stack
+files, and to @EdgarsJudovics for helping keep the script-free installation
+path documented.
+
+Thx as well to everyone testing the beta, reporting playback and buffering
+problems, or helping other self-hosters.
+
+## Updating
+
+Follow the
+[update guide](https://typetype-video.github.io/Docs-TypeType/self-hosting/maintenance).
+
+If necessary, follow the
+[rollback guide](https://typetype-video.github.io/Docs-TypeType/self-hosting/rollback).
+
+If u want to support TypeType, please share it with others. If u want to
+support it financially, u can do so through
+[GitHub Sponsors](https://github.com/sponsors/Priveetee).

docker-compose.dev.yml

@@ -3,11 +3,14 @@ services:
     image: ${TYPETYPE_WEB_BETA_IMAGE:-ghcr.io/typetype-video/typetype-beta:latest}
     ports:
       - "${HOST_PORT_WEB_BETA:-18082}:80"
-    volumes:
-      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
     depends_on:
       typetype-server:
         condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1/api/version/web"]
+      interval: 5s
+      timeout: 3s
+      retries: 12
     restart: unless-stopped
 
   typetype-server:
@@ -21,7 +24,7 @@ services:
       DATABASE_PASSWORD: ${DATABASE_PASSWORD:-${POSTGRES_PASSWORD:-typetype}}
       DRAGONFLY_URL: ${DRAGONFLY_URL:-redis://dragonfly:6379}
       DOWNLOADER_SERVICE_URL: http://typetype-downloader:18093
-      YOUTUBE_OUTBOUND_PROXY_URL: ${YOUTUBE_OUTBOUND_PROXY_URL:-}
+      YOUTUBE_OUTBOUND_PROXY_URL: ${YOUTUBE_OUTBOUND_PROXY_URL:?YOUTUBE_OUTBOUND_PROXY_URL is required}
       YOUTUBE_REMOTE_LOGIN_ENABLED: ${YOUTUBE_REMOTE_LOGIN_ENABLED:-false}
       YOUTUBE_REMOTE_LOGIN_SERVICE_URL: http://typetype-token:8081
       YOUTUBE_REMOTE_LOGIN_CALLBACK_BASE_URL: http://typetype-server:8080
@@ -90,7 +93,7 @@ services:
     ipc: host
     environment:
       NODE_ENV: production
-      YOUTUBE_OUTBOUND_PROXY_URL: ${YOUTUBE_OUTBOUND_PROXY_URL:-}
+      YOUTUBE_OUTBOUND_PROXY_URL: ${YOUTUBE_OUTBOUND_PROXY_URL:?YOUTUBE_OUTBOUND_PROXY_URL is required}
       YOUTUBE_REMOTE_LOGIN_ENABLED: ${YOUTUBE_REMOTE_LOGIN_ENABLED:-false}
       YOUTUBE_REMOTE_LOGIN_INTERNAL_TOKEN: ${YOUTUBE_REMOTE_LOGIN_INTERNAL_TOKEN:-}
       YOUTUBE_REMOTE_LOGIN_CALLBACK_ORIGIN: ${YOUTUBE_REMOTE_LOGIN_CALLBACK_ORIGIN:-http://typetype-server:8080}
@@ -136,26 +139,70 @@ services:
     restart: "no"
 
   dragonfly:
-    image: docker.dragonflydb.io/dragonflydb/dragonfly:latest
+    image: docker.dragonflydb.io/dragonflydb/dragonfly:v1.39.0
     ulimits:
       memlock: -1
     healthcheck:
       test: ["CMD", "redis-cli", "ping"]
     restart: unless-stopped
 
+  garage-config:
+    image: busybox:1.37
+    command:
+      - /bin/sh
+      - -ec
+      - |
+        config=/etc/garage/garage.toml
+        if [ -s "$$config" ]; then
+          exit 0
+        fi
+        umask 077
+        if [ -s /migration/garage.toml ]; then
+          cp /migration/garage.toml "$$config"
+          exit 0
+        fi
+        cat > "$$config" <<'EOF'
+        metadata_dir = "/var/lib/garage/meta"
+        data_dir = "/var/lib/garage/data"
+        db_engine = "sqlite"
+
+        replication_factor = 1
+
+        rpc_bind_addr = "[::]:3901"
+        rpc_public_addr = "127.0.0.1:3901"
+
+        [s3_api]
+        s3_region = "garage"
+        api_bind_addr = "[::]:3900"
+        EOF
+    volumes:
+      - garage_config:/etc/garage
+      - ./.typetype-migration:/migration:ro
+    restart: "no"
+
   garage:
     image: dxflrs/garage:v2.2.0
     ports:
       - "${HOST_BIND_GARAGE_S3_BETA:-127.0.0.1}:${HOST_PORT_GARAGE_S3_BETA:-3900}:3900"
     environment:
+      GARAGE_CONFIG_FILE: /etc/garage/garage.toml
       GARAGE_RPC_SECRET: ${GARAGE_RPC_SECRET:-}
     volumes:
-      - ./garage.toml:/etc/garage.toml:ro
+      - garage_config:/etc/garage
       - garage_meta:/var/lib/garage/meta
       - garage_data:/var/lib/garage/data
+    depends_on:
+      garage-config:
+        condition: service_completed_successfully
+    healthcheck:
+      test: ["CMD", "/garage", "status"]
+      interval: 5s
+      timeout: 3s
+      retries: 12
     restart: unless-stopped
 
 volumes:
   postgres_data:
+  garage_config:
   garage_meta:
   garage_data:

docker-compose.yml

@@ -3,11 +3,14 @@ services:
     image: ${TYPETYPE_WEB_IMAGE:-ghcr.io/typetype-video/typetype:latest}
     ports:
       - "${HOST_PORT_WEB:-8082}:80"
-    volumes:
-      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
     depends_on:
       typetype-server:
         condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1/api/version/web"]
+      interval: 5s
+      timeout: 3s
+      retries: 12
     restart: unless-stopped
   typetype-server:
     image: ${TYPETYPE_SERVER_IMAGE:-ghcr.io/typetype-video/typetype-server:latest}
@@ -50,7 +53,7 @@ services:
     restart: unless-stopped
 
   typetype-secrets:
-    image: busybox:1.37
+    image: busybox:1.38
     command:
       - /bin/sh
       - -ec
@@ -176,25 +179,69 @@ services:
     restart: "no"
 
   dragonfly:
-    image: docker.dragonflydb.io/dragonflydb/dragonfly:latest
+    image: docker.dragonflydb.io/dragonflydb/dragonfly:v1.39.0
     ulimits:
       memlock: -1
     healthcheck:
       test: ["CMD", "redis-cli", "ping"]
     restart: unless-stopped
+  garage-config:
+    image: busybox:1.37
+    command:
+      - /bin/sh
+      - -ec
+      - |
+        config=/etc/garage/garage.toml
+        if [ -s "$$config" ]; then
+          exit 0
+        fi
+        umask 077
+        if [ -s /migration/garage.toml ]; then
+          cp /migration/garage.toml "$$config"
+          exit 0
+        fi
+        cat > "$$config" <<'EOF'
+        metadata_dir = "/var/lib/garage/meta"
+        data_dir = "/var/lib/garage/data"
+        db_engine = "sqlite"
+
+        replication_factor = 1
+
+        rpc_bind_addr = "[::]:3901"
+        rpc_public_addr = "127.0.0.1:3901"
+
+        [s3_api]
+        s3_region = "garage"
+        api_bind_addr = "[::]:3900"
+        EOF
+    volumes:
+      - garage_config:/etc/garage
+      - ./.typetype-migration:/migration:ro
+    restart: "no"
+
   garage:
     image: dxflrs/garage:v2.2.0
     ports:
       - "${HOST_BIND_GARAGE_S3:-127.0.0.1}:${HOST_PORT_GARAGE_S3:-3900}:3900"
     environment:
+      GARAGE_CONFIG_FILE: /etc/garage/garage.toml
       GARAGE_RPC_SECRET: ${GARAGE_RPC_SECRET:-}
     volumes:
-      - ./garage.toml:/etc/garage.toml:ro
+      - garage_config:/etc/garage
       - garage_meta:/var/lib/garage/meta
       - garage_data:/var/lib/garage/data
+    depends_on:
+      garage-config:
+        condition: service_completed_successfully
+    healthcheck:
+      test: ["CMD", "/garage", "status"]
+      interval: 5s
+      timeout: 3s
+      retries: 12
     restart: unless-stopped
 volumes:
   postgres_data:
   typetype_secrets:
+  garage_config:
   garage_meta:
   garage_data: