-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathREADME
81 lines (53 loc) · 3.24 KB
/
README
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
audio2ascii: (Only Linux and Mac Osx)
===========
Natron2.0 python plugin to animate you parameters with waveform from an audio file(mp3, wav,aiff,...).
It try to preview audio while viewer playing. it can be usefull until the basic sound support in future Natron versions (>2.0).
An external app can be set and launch from the plugin to edit audio file (e.g. audacity..).
The plugin use a bash script(audio2ascii.sh), sox to convert audio and ffplay(from ffpmeg) to play the preview.(only for OSX and Linux for now).
A multiplatform Qt version of the bash script are currently being developed by @olear at:
https://github.com/olear/audiocurve
Installation / Usage:
====================
Just copy audio2ascii.sh, AudioToAscii.py and AudioToAscii.png in your Home Natron Plugins directory.
1. For Linux
$ wget https://github.com/rcspam/audio2ascii/releases/download/v2.0/v2.0-linux.tar.gz
$ tar xvzf audio2ascii-2.0.tar.gz
$ cd audio2ascii-2.0beta
$ ./install_Unix.sh
2. For OSX
Download last version at https://github.com/rcspam/audio2ascii/releases/download/v2.0/v2.0-macosx.tar.gz.
Decompress it where you want and launch './install_Unix.sh' from the directory in terminal,
or open archive and copy all files in '/Users/<username>/Library/Application Support/INRIA/Natron/Plugins'.
3.For Windows
Download last version at https://github.com/rcspam/audio2ascii/releases/download/v2.0/v2.0-win.zip.
Open archive and copy all files in 'C:\Users\<username>\Local Settings\Application Data\INRIA\Natron\Plugins'
4. Some extras (Optional):
- If you want add a menu command to the Natron menu-bar, add the following lines in the init.py of your home Natron plugin directory (create it if doesn't exist):
# Linux
import os
def audioToAscii():
os.system("$HOME/.local/share/INRIA/Natron/Plugins/audio2ascii.sh -g &")
NatronGui.natron.addMenuCommand("Ext-Tools/AudioToAscii","audioToAscii",QtCore.Qt.Key.Key_L,QtCore.Qt.KeyboardModifier.ShiftModifier)
# OSX
import os
def audioToAscii():
os.system("$HOME/Library/Application\ Support/INRIA/Natron/Plugins/audio2ascii.sh -g &")
NatronGui.natron.addMenuCommand("Ext-Tools/AudioToAscii","audioToAscii",QtCore.Qt.Key.Key_L,QtCore.Qt.KeyboardModifier.ShiftModifier)
- Linux users can run audio2ascii.sh as standalone to create ascii curves (yad must be installed)
$ your/path/to/audio2ascii.sh -g
Requirements:
============
- sox:
sudo apt-get install sox or sudo yum install sox.(Debian / Fedora)
For support more audio formats than 'wav': sudo apt-get install libsox-fmt-all (debian).
Fedora: for mp3 support for sox you can read:
https://unix.stackexchange.com/questions/98524/sox-returns-an-error-when-i-try-to-handle-mp3-fileshttps://unix.stackexchange.com/questions/98524/sox-returns-an-error-when-i-try-to-handle-mp3-files
Mac OSX: sudo port install sox (After have installed Xcode and Command Line Tools)
No needed for Widows users
- ffmpeg
Debian/Ubuntu: sudo apt-get install ffmpeg or sudo yum install ffmpeg
Mac OSX: sudo port install ffmpeg
- gawk (OSX users only, awk doesn't support floats): sudo port install gawk
- yad (optional, stand alone GUI on Linux):
Debian/Ubuntu: sudo apt-get install yad
Fedora:sudo yum install yad