Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
GUI and command-line utility for converting audiobooks to m4b format
branch: master
Failed to load latest commit information.
AudioBookBinder.xcodeproj Show multiple stats in dock icon
Sparkle.framework Update Sparkle framework version
de.lproj Make chapter mode default global, but audiolist mode local
en.lproj Make chapter mode default global, but audiolist mode local
fr.lproj Make chapter mode default global, but audiolist mode local
it.lproj Make chapter mode default global, but audiolist mode local
nb.lproj Make chapter mode default global, but audiolist mode local
ru.lproj Make chapter mode default global, but audiolist mode local
.gitignore Add generic .gitignore for Xcode projects
ABLog.h Initial commit
ABLog.m Initial commit
AudioBinder.h Workaround for crash bug in Lion
AudioBinder.m Fix warnings
AudioBinderVolume.h Add class that represents audiobook volume
AudioBinderVolume.m Add class that represents audiobook volume
AudioBinderWindowController.h Update window title when it resigns being key window
AudioBinderWindowController.m Unbreak non-appstore build
AudioBookBinder-Info.plist Bump version
AudioBookBinder.1 Initial commit
AudioBookBinder.entitlements Add entitlement
AudioBookBinder.m Replace obsolete strignWithCString
AudioBookBinderAppDelegate.h Fix bitrate part of preferences dialog
AudioBookBinderAppDelegate.m Make chapter mode default global, but audiolist mode local
AudioBookBinder_Prefix.pch
AudioFile.h Add sorting by column
AudioFile.m Fix null characters in the end of artist/title
AudioFileList.h Refactor
AudioFileList.m Make chapter mode default global, but audiolist mode local
AuidoBookBinder.m Add some initial GUI layout for AudioBookBinder
ChangeLog Update Changelog
Chapter.h Add sorting by column
Chapter.m Add sorting by column
Chapters - HowTo.webloc weblink file for DMG with the link to Chapters HowTo
ConfigNames.h Replace hardcoded config var names with constants
ConsoleDelegate.h Conform new delegate protocol (volume support)
ConsoleDelegate.m
CoverImageView.h Improve audiobook cover handling
CoverImageView.m Use drawAtPoint instead of deprecate compositeToPoint
Credits.rtf Add authro of italian translation to credits
ExpandedPathToIconTransformer.h - Path/Icon transformers for Cocoa Bindings
ExpandedPathToIconTransformer.m - Path/Icon transformers for Cocoa Bindings
ExpandedPathToPathTransformer.h - Path/Icon transformers for Cocoa Bindings
ExpandedPathToPathTransformer.m - Path/Icon transformers for Cocoa Bindings
MP4Atom.h More options for MP4 file customization
MP4Atom.m Use spaces instead of tabs in sources
MP4File.h Expose genre setting to class users
MP4File.m Expose genre setting to class users
MetaEditor.h Add chapters support for command-line client
MetaEditor.mm Style & debug output clean-up
MiniProgressGradient.png Add total progress bar on dock incon
NSOutlineView_Extension.h Refactor
NSOutlineView_Extension.m Refactor
Play.png
PrefsController.h Fix bitrate part of preferences dialog
PrefsController.m Unbreak non-appstore build
README Update documentation
StatsManager.h Remove unused property
StatsManager.m Remove unused property
Stop.png Add "play file" button
abbinder.m Set output files explicitly using -o switch
audiobook.icns Regenerate icns to conform requirements
mkdmg.sh Bundle abbinder with main GUI application
sparkle_dsa_pub.pem Add Sparkle framework for autoupdates

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
Something went wrong with that request. Please try again.