GUI and command-line utility for converting audiobooks to m4b format
Objective-C Objective-C++ Other
Permalink
Failed to load latest commit information.
AudioBookBinder.xcodeproj Switch to base-based localization Sep 13, 2016
Base.lproj Switch to base-based localization Sep 13, 2016
Sparkle.framework Update Sparkle framework version Apr 30, 2013
de.lproj
en.lproj Switch to base-based localization Sep 13, 2016
fr.lproj
it.lproj Switch to base-based localization Sep 13, 2016
nb.lproj
ru.lproj
.gitignore Add generic .gitignore for Xcode projects Jun 28, 2011
ABLog.h Update copyright May 3, 2016
ABLog.m Update copyright May 3, 2016
AudioBinder.h Minor refactoring May 3, 2016
AudioBinder.m
AudioBinderWindowController.h Add Reader field Sep 13, 2016
AudioBinderWindowController.m
AudioBookBinder-Info.plist
AudioBookBinder-appstore.entitlements Add appstore entitlement file Sep 13, 2016
AudioBookBinder.1 Initial commit Aug 9, 2009
AudioBookBinder.entitlements
AudioBookBinder.m Fix typo in main file for GUI app May 1, 2016
AudioBookBinderAppDelegate.h Make QueueController field property Sep 13, 2016
AudioBookBinderAppDelegate.m Make QueueController field property Sep 13, 2016
AudioBookBinder_Prefix.pch
AudioBookVolume.h Minor refactoring May 2, 2016
AudioBookVolume.m Minor refactoring May 2, 2016
AudioFile.h Minor refactoring May 2, 2016
AudioFile.m
AudioFileList.h Fix typo in getter name May 6, 2016
AudioFileList.m Fix drag'n'drop bug May 8, 2016
ChangeLog Update Changelog Dec 2, 2010
Chapter.h Fix drag'n'drop bug May 8, 2016
Chapter.m Fix drag'n'drop bug May 8, 2016
Chapters - HowTo.webloc weblink file for DMG with the link to Chapters HowTo Dec 2, 2010
ConfigNames.h Update copyright header May 2, 2016
ConsoleDelegate.h Minor refactoring May 1, 2016
ConsoleDelegate.m Minor refactoring May 1, 2016
CoverImageView.h
CoverImageView.m Refactoring May 1, 2016
Credits.rtf
ExpandedPathToIconTransformer.h Minor clean-ups May 1, 2016
ExpandedPathToIconTransformer.m Minor clean-ups May 1, 2016
ExpandedPathToPathTransformer.h Minor clean-ups May 1, 2016
ExpandedPathToPathTransformer.m
MP4Atom.h Cosmetic refactoring May 1, 2016
MP4Atom.m Cosmetic refactoring May 1, 2016
MP4File.h Add Reader field Sep 13, 2016
MP4File.m Add Reader field Sep 13, 2016
MetaEditor.h
MetaEditor.mm Cosmetic refactoring May 1, 2016
MiniProgressGradient.png Add total progress bar on dock incon Jul 13, 2011
NSOutlineView_Extension.h Update copyright header May 1, 2016
NSOutlineView_Extension.m Update copyright header May 1, 2016
Play.png
PrefsController.h Cosmetic refactoring May 1, 2016
PrefsController.m Cosmetic refactoring May 1, 2016
QueueController.h
QueueController.m Some Queue window/controller improvements Sep 13, 2016
QueueOverlayView.h Add some basic toggle queue funcionality May 16, 2016
QueueOverlayView.m
QueueWindow.xib Some Queue window/controller improvements Sep 13, 2016
README
StatsManager.h Cosmetic refactor May 1, 2016
StatsManager.m
Stop.png
abbinder.m Update copyright May 3, 2016
audiobook.icns Add 512x512 icon Jul 1, 2015
mkdmg.sh
sparkle_dsa_pub.pem Add Sparkle framework for autoupdates Apr 3, 2010

README

= Command line utility: abbinder 
As of 1.18 it's part of main bundler. Path to the utility is:
    AudioBookBinder.app/Contents/MacOS/abbinder

== Usage
abbinder [-hsv] [-c 1|2] [-r samplerate] [-a author] [-t title] 
  [-i filelist] outfile [@chapter_1@ infile @chapter_2@ ...]
        -a author       set book author
        -c 1|2          number of channels in audiobook. Default: 2
        -C file.png     cover image
        -e              alias for -E ''
        -E template     make each file a chapter with name defined by template
                            %N - chapter number
                            %a - artis (obtained from source file)
                            %t - title (obtained from source file)
        -h              show this message
        -i file         get input files list from file, "-" for standard input
        -q              quiet mode (no output)
        -r rate         sample rate of audiobook. Default: 44100
        -s              skip errors and go on with conversion
        -t title        set book title
        -v              print some info on files being converted

Attributes for -a and -t arguments (author and title) should be in UTF8.
Only jpeg and png are supported as cover page format. 
Valid sample rate values:
    8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000

Chapters could be set either by chapter markers in file list or by
treating each source file as a chapter.  In former case chapter name is
provided by user and should be enclosed in '@' characters to distinguish
it from file names. e.g.:
    abbinder book.m4b '@Chapter 1@' track01.mp3 '@Chapter 2@' track02.mp3

Chapter names in the latter case are generated for each input file and 
may contain some escaped sequences that would be expanded when creating 
a chapter. Template is provided as argument for -E switch. 
Available sequences:
    %N - number of chapter, starts from 1
    %a - value of 'artist' tag from source file
    %t - value of 'title' tag from source file

So previous example could be rewritten like:
    abbinder -E 'Chapter %N' track01.mp3 track02.mp3

== Examples

Convert one file to m4b
  bash$ abbinder book.m4b myfile.mp3

Convert several files to mono m4b with sample rate 8000
  bash$ abbinder -r 8000 -c 1 book.m4b myfile.mp3 myfile2.mp3

Convert all mp3 files in directory and set author, title and cover image
  bash$ find ./dir -name '*mp3' > list
  bash$ abbinder -i list -a Author -t Title -C ~/cover.png out.m4b

Convert three-chapter book with explicit chapter names:
  bash$ abbinder book.m4b '@The very beginning@' 01.mp3 \
      '@In the middle of something@' 02.mp3 \
      '@Ashes to ashes and dust to dust@' 03.mp3

Convert several short-stories files and make each of them a chapter
  bash$ abbinder -E '%t' story01.mp3 story02.mp3 story03.mp3