jaysonsantos/copy-media

copy-media 镜像文档

概述

copy-media是一个轻量级媒体文件整理工具，旨在帮助用户将分散的媒体文件从源目录复制到目标目录，并根据预定义的类型映射规则自动分类到对应子文件夹中，实现媒体文件的有序管理。

核心功能与特性

• 目录复制：支持指定源目录（--from）和目标目录（--to），实现媒体文件的批量复制
• 类型映射：通过--mapping参数定义媒体类型与目标子文件夹的对应关系（如movie Movies表示将电影类型文件归类到Movies子文件夹）
• 简单配置：命令行参数直接配置，无需复杂配置文件

使用场景

• 个人媒体库整理：将下载目录中混乱的电影、剧集等文件自动分类到指定文件夹
• 媒体文件迁移：在不同存储位置间迁移媒体文件时保持分类结构
• 定期媒体整理任务：配合定时任务工具，实现媒体文件的自动定期分类

使用方法

基本命令格式

bash
copy-media \
  --from <源目录路径> \
  --to <目标目录路径> \
  [--mapping <媒体类型> <目标子文件夹>]...

参数说明

Docker部署示例

直接运行（docker run）

bash
docker run -v ~/Scrambled:/source -v ~/Organized:/target docker.xuanyuan.run/copy-media \
  --from /source \
  --to /target \
  --mapping movie Movies \
  --mapping episode Series

说明：通过-v参数将本地源目录（/Scrambled）挂载到容器内的/source，目标目录（/Organized）挂载到/target，工具将在容器内执行文件复制和分类。

docker-compose配置

yaml
version: '3'
services:
  copy-media:
    image: docker.xuanyuan.run/copy-media
    volumes:
      - ~/Scrambled:/source
      - ~/Organized:/target
    command: >
      --from /source
      --to /target
      --mapping movie Movies
      --mapping episode Series

注意事项

• 确保源目录和目标目录具有读写权限
• 媒体类型的识别规则由工具内部实现，具体支持的媒体类型需参考工具详细文档
• 复制过程中若目标文件已存在，工具可能会覆盖或跳过（具体行为取决于工具实现）