PyAudacity

一个Python模块，用于通过mod-script-pipe宏系统控制正在运行的Audacity实例。

重要！如果您使用此模块，请与al@inventwithpython.com联系。我想了解人们如何使用它以及我可以做出哪些更改或优先考虑哪些功能。

安装

使用pip安装，请运行

pip install pyaudacity

PyAudacity是一个纯Python模块，没有依赖关系，尽管您必须安装Audacity。在您的Python脚本使用PyAudacity时，Audacity必须处于打开状态。（也就是说，PyAudacity没有“无头”模式。）

重要：您必须在Audacity中启用mod-script-pipe模块后才能使用PyAudacity！启动Audacity，打开“首选项”菜单，点击侧边栏中的“模块”部分，然后将mod-script-pipe从“新建”切换到“启用”。然后您必须重新启动Audacity。

mod-script-pipe模块从Audacity的3.2.0版本开始提供。如果您在“模块”部分看不到它，您必须...我不知道。 文档中没有说明您可以从哪里下载它。如果您有关于在Windows、macOS和Linux上安装它的说明，请通过电子邮件al@inventwithpython.com发送给我，以便我可以在此处发布它们。

快速入门指南

注意：使用此模块之前，Audacity必须正在运行。

注意：如果您打开了多个Audacity窗口，您运行的宏将在最后打开的Audacity窗口上工作。您不能选择将宏发送到哪个窗口。

注意：从PyAudacity或mod-script-pipe系统运行的自定义宏不会添加到项目的撤销历史中。

注意：在Windows上，如果您看到 OSError: [Errno 22] Invalid argument: '\\\\.\\pipe\\ToSrvPipe'，您必须以管理员身份运行Python脚本。我不知道为什么有时需要这样做，有时则不需要。

目前，PyAudacity处于半完成状态。我正在等待人们的反馈，看看这个模块是否真正有用。请通过al@inventwithpython.com给我发电子邮件

请查看Audacity维基百科上的脚本参考页面，了解有关各种宏的文档。您可以通过调用 pyaudacity.do() 在当前打开的Audacity项目中运行这些宏。

例如，以下创建了一个新项目，并添加了一个两秒的布朗运动样本

>>> import pyaudacity as pa
>>> pa.do('New')
'\nBatchCommand finished: OK\n'
>>> pa.do('NewMonoTrack')
'\nBatchCommand finished: OK\n'
>>> pa.do('SelectTime: Start="1" End="3"')
'\nBatchCommand finished: OK\n'
>>> pa.do('Noise: Type="Brownian" Amplitude="0.8"')
'\nBatchCommand finished: OK\n'

如果您输入了错误的参数名称，Audacity的宏将静默失败。（或者有时，会出现一个弹出警告窗口，这也会停止任何自动化，直到有人关闭它。）

PyAudacity的目标是通过提供do()函数以及几个在传递无效参数时引发PyAudacityException的便利函数，使Audacity宏系统易于使用。

例如，以下与上面的例子做相同的事情

>>> import pyaudacity as pa
>>> pa.new()
'\nBatchCommand finished: OK\n'
>>> pa.new_mono_track()
'\nBatchCommand finished: OK\n'
>>> pa.select_time(1.0, 3.0)
'\nBatchCommand finished: OK\n'
>>> pa.noise(noise_type='Brownian', amplitude=0.8)
'\nBatchCommand finished: OK\n'

PyAudacity仍在开发中，还有很多工作要做以验证参数。您始终可以使用do()函数，但请注意，便利函数的功能签名可能会在未来快速更改，因为该库正在开发中。因此，找到函数的最佳方法是通过检查源代码，遗憾的是。

PyAudacity的Audacity宏功能愿望清单

如果Audacity添加以下内容到宏系统将非常棒

• 一个宏批量命令来检索Audacity的版本号。