Skip to content

Commit

Permalink
Update Readme.md, Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
rcspam committed Jul 4, 2015
1 parent 1d48a24 commit a476b30
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 19 deletions.
33 changes: 23 additions & 10 deletions README
Original file line number Diff line number Diff line change
@@ -1,9 +1,12 @@
audio2ascii
audio2ascii:
===========

Convert an audio file to an ascii file readable by the Natron/Nuke curve editor.
Convert an audio file to an ascii file readable by the Natron/Nuke curve editor (Linux only).
A Qt version (Linux + Windows) are currently being developed by @olear at:
https://github.com/olear/audio2ascii

Requirements

Requirements:
============

- Sox: sudo apt-get install sox or sudo yum install sox.
Expand All @@ -14,11 +17,21 @@ Requirements

- Yad: If you want a gui: sudo apt-get install yad ; sudo yum install yad

Installation / Usage
Installation / Usage:
====================

$ wget https://github.com/rcspam/audio2ascii/releases/download/v1.2/audio2ascii
$ chmod +x ./audio2ascii
$ ./audio2ascii --help # launch command line to know the parameters
$ ./audio2ascii -g # or launch with gui (see Requirements above)

$ wget https://github.com/rcspam/audio2ascii/archive/v1.3.tar.gz
$ tar xvzf audio2ascii-1.3.tar.gz
$ cd audio2ascii-1.3
$ cp ./audio2ascii.sh /somewhere/in/your/path # must be in your $PATH

to install the plugin: AudioToAscii.py:
$ # create the local Plugins directory if it doesn't exist
$ mkdir $HOME/.local/share/INRIA/Natron/Plugins
$ cp ./AudioToAscii.* $HOME/.local/share/INRIA/Natron/Plugins

If you want just add a menu command to the application’s menu-bar,
add the following lines in your $HOME/.local/share/INRIA/Natron/Plugins/init.py
(create init.py if doesn't exist):
def audioToAscii():
os.system("audio2ascii.sh -g &")
natron.addMenuCommand("Ext-Tools/AudioToAscii","audioToAscii",QtCore.Qt.Key.Key_L,QtCore.Qt.KeyboardModifier.ShiftModifier)
34 changes: 25 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,41 @@
# audio2ascii

Convert an audio file to an ascii file readable by the Natron/Nuke curve editor.

Convert an audio file to an ascii file readable by the Natron/Nuke curve editor. (Linux only)
A Qt version (Linux + Windows) are currently being developed by @olear at https://github.com/olear/audio2ascii

#Requirements

* [Sox](http://sox.sourceforge.net/): **sudo apt-get install sox** or **sudo yum install sox**.

For support more audio formats than 'wav': **sudo apt-get install libsox-fmt-all** (debian).

Fedora: for mp3 support for sox you can read [this](https://unix.stackexchange.com/questions/98524/sox-returns-an-error-when-i-try-to-handle-mp3-files)

* [Yad](http://sourceforge.net/projects/yad-dialog): If you want a gui: **sudo apt-get install yad** ; **sudo yum install yad**

#Installation / Usage

```
$ wget https://github.com/rcspam/audio2ascii/releases/download/v1.2/audio2ascii
$ chmod +x ./audio2ascii
$ ./audio2ascii --help # launch command line to know the parameters
$ ./audio2ascii -g # or launch with gui (see Requirements above)
$ wget https://github.com/rcspam/audio2ascii/archive/v1.3.tar.gz
$ tar xvzf audio2ascii-1.3.tar.gz
$ cd audio2ascii-1.3
$ cp ./audio2ascii.sh /somewhere/in/your/path # must be in your $PATH
```
to install the plugin: AudioToAscii.py:
```
$ # create the local Plugins directory if it doesn't exist
$ mkdir $HOME/.local/share/INRIA/Natron/Plugins
$ cp ./AudioToAscii.* $HOME/.local/share/INRIA/Natron/Plugins
```
If you want just add a menu command to the application’s menu-bar, add the following lines in your $HOME/.local/share/INRIA/Natron/Plugins/init.py (create init.py if doesn't exist):

```
import os
def audioToAscii():
os.system("audio2ascii.sh -g &")
natron.addMenuCommand("Ext-Tools/AudioToAscii","audioToAscii",QtCore.Qt.Key.Key_L,QtCore.Qt.KeyboardModifier.ShiftModifier)
```

#Examples

Some short videos released with the [Natron 2 Snapshot](http://sourceforge.net/projects/natron/files/snapshots/) Transform Node:
Expand Down

0 comments on commit a476b30

Please sign in to comment.