数字时代的记忆保管箱Shoebox

发表于 分类于 Waline： 阅读次数： 本文字数： 2.8k 阅读时长 ≈ 3 分钟
Shoebox 是一种数字解决方案，用于在您的一生中组织和保存您的视频。

简介

什么是 Shoebox ？

Shoebox 是一个数字解决方案，旨在组织和保存视频，模拟过去人们用实体鞋盒保存珍贵记忆的方式。它为用户提供了一个专门的空间，以避免视频在云服务或社交媒体平台中丢失。

主要特点

  1. 视频组织：能够有效地组织用户的视频，便于未来的回顾和使用。
  2. 视频导出功能：支持将原始视频导出到指定位置，方便导入到视频编辑器中进行后续处理。
  3. 记忆保存：以结构化的方式保存视频记忆，使其易于访问并可用于未来的创意项目。
  4. 用户友好的界面：提供简单易用的界面，方便用户进行视频管理。
  5. 高效的媒体处理：使用 FFmpeg 进行视频处理，确保操作的高效性和准确性。
  6. 技术栈：后端使用 Rust 和 Axum，前端基于 React 和 TypeScript，支持 SQLite/PostgreSQL 数据库，并具备 Docker/Kubernetes 部署能力。

应用场景

  • 家庭视频管理：适合家庭用户保存和组织孩子成长过程中的视频，方便随时回顾。
  • 创意项目：为视频创作者提供一个结构化的存储解决方案，便于未来制作高光集或拼贴。
  • 教育记录：教育工作者可以使用 Shoebox 保存教学视频，以便于未来的教学参考。

Shoebox 通过提供安全、方便的视频管理解决方案，帮助用户有效地保存和利用数字记忆。

安装

在群晖上以 Docker 方式安装。

本文写作时， latest 版本对应为 sha-9f05da53931ad6fa4f5b7f1d9b447ca65dec3e8b；

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 新建文件夹 shoebox 和 子目录
mkdir -p /volume1/docker/shoebox/{data,exports,thumbnails,videos}

# 进入 shoebox 目录
cd /volume1/docker/shoebox

# 运行容器
docker run -d \
  --name shoebox \
  --restart unless-stopped \
  -p 3823:3000 \
  -v $(pwd)/videos:/mnt/videos:ro \
  -v $(pwd)/exports:/app/exports \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/thumbnails:/app/thumbnails \
  -e SERVER_HOST=0.0.0.0 \
  -e SERVER_PORT=3000 \
  -e DATABASE_URL=sqlite:/app/data/videos.db \
  -e MEDIA_SOURCE_PATHS=/mnt/videos \
  -e THUMBNAIL_PATH=/app/thumbnails \
  -e EXPORT_BASE_PATH=/app/exports \
  -e RUST_LOG=info \
  ghcr.io/slackspace-io/shoebox:latest
  • 映射路径的说明
文件夹 装载路径 说明
docker/shoebox/videos /mnt/videos 存放视频文件
docker/shoebox/exports /app/exports 存放导出内容
docker/shoebox/data /app/data 存放数据库文件
docker/shoebox/thumbnails /app/thumbnails 存放缩略图文件
  • 环境变量的说明
可变 值
SERVER_HOST 用于绑定服务器的主机，缺省值为 127.0.0.1
SERVER_PORT 用于绑定服务器的端口，缺省值为 3000
DATABASE_URL 数据库连接 URL，支持 SQLite/PostgreSQL
MEDIA_SOURCE_PATHS 扫描视频的路径，可以指定一个或多个路径，以逗号分隔
THUMBNAIL_PATH 存储缩略图的路径
EXPORT_BASE_PATH 导出文件的路径
RUST_LOG 日志级别

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
version: '3.8'

services:
  app:
    image: ghcr.io/slackspace-io/shoebox:latest
    container_name: shoebox
    restart: unless-stopped
    ports:
      - "3823:3000"
    volumes:
      # Mount media source directories (read-only)
      - ./videos:/mnt/videos:ro
      # Mount export directory (read-write)
      - ./exports:/app/exports
      # Mount data directory for persistence
      - ./data:/app/data
      # Mount thumbnails directory for persistence
      - ./thumbnails:/app/thumbnails
    environment:
      - SERVER_HOST=0.0.0.0
      - SERVER_PORT=3000
      - DATABASE_URL=sqlite:/app/data/videos.db
      - MEDIA_SOURCE_PATHS=/mnt/videos
      - THUMBNAIL_PATH=/app/thumbnails
      - EXPORT_BASE_PATH=/app/exports
      - RUST_LOG=info

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 shoebox 和 子目录
mkdir -p /volume1/docker/shoebox/{data,exports,thumbnails,videos}

# 进入 shoebox 目录
cd /volume1/docker/shoebox

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:3823 就能看到主界面

在 videos 目录中放入视频文件

点 Scan Directories 扫描视频目录

开始扫描

扫描完成后

进入视频详情

参考文档

slackspace-io/shoebox
地址：https://github.com/slackspace-io/shoebox

Introduction - Shoebox Docs
地址：https://slackspace-io.github.io/shoebox/

Demo of shoebox - YouTube
地址：https://www.youtube.com/watch?v=xfPMCLWnUz8