organize-media-files 1.0.1

什么是omf？

organize media files（omf）是一个命令行实用程序，它帮助用户根据元数据标记和可配置的规则分派未排序的媒体文件。omf正在使用Mutagen来处理音频文件。稍后将添加更多的媒体文件支持。

安装

使用pip安装：

$ pip install organize_media_files

开始

成功安装后，您可以看到omf通过进入位于omf顶级源代码树目录中的example/来完成它的工作。

$ cd example/

在这里您可以看到example.conf和一些示例音频文件，其中包含填充的元标记。类型：

$ omf -d -c example.conf sample_mp3.mp3

Moving:
example/sample_mp3.mp3
To:
/tmp/omf_example/some_artist_mp3 - some_title_mp3

您可以看到omf在--dry-run中运行。它旨在防止意外行为，并向用户显示在指定配置中将发生的事情。在匆忙使用omf之前，不要忘记使用.conf文件设置正确的配置。

配置文件

OMF提供示例system.conf和user.conf，两者都位于/etc/.omfrc/目录。配置文件由两部分组成。[pattern s]部分是用户设置的分派路径的-apattern部分，必须以绝对路径的形式给出（'~'可用于指定home目录），并包含{metatags}。

Unix系统中的音频文件模式示例：

uno = ~/Music/{artist}/{tracknumber}-{title}

音频文件的有效{metatags}是：{artist}，{title}，{album}，{tracknumber}，{genre}，{date}，{encoder}。由于实用性的简单性，OMF不会用词法分析模式（除了有效的^ {TT2}$），所以用户可以指定正确的模式（使用^ {TT1}$选项来查看OMF将要做什么）。

用法

OMF的基本用法是：

$ omf filename_1 filename_2

在这种情况下，filename_1和filename_2将根据user.conf中的默认模式进行调度。

选项：

• -h,--help-显示帮助消息。
• -d,--dry-run-运行omf而不实际移动文件并打印详细信息。
• -c FILE, --config FILE-指定另一个配置文件。
• ^ TT18}$-忽略不一致或/和重写文件（例如，如果一个文件，在给定的文件名列表中，已经存在相同的名称，改写它）。
• -pPATTERN-NAME,--pattern PATTERN_NAME-显式指定分派模式。

待办事项

1. 创建文档。
2. 找出如何将user.conf移动到主目录（上面有bug）。
3. 为模式添加bash完成。
4. 将扩展名追加到dispathed文件的末尾。

对未来的一些警告

1. OMF使用pathlib.path（模式指定路径）分派文件。这种行为会导致使用上的误解。