aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2020-05-08 20:14:29 -0400
committerB. Watson <yalhcru@gmail.com>2020-05-08 20:18:28 -0400
commite7c665d3c43fcad0f2e3f893b633f44c8fb18a38 (patch)
tree60d25770a3e0d45fbff1009d651aa1e7709a3da8 /README
parenteda5398a6dd6e40eac3eaf0dc94f949b2322a16a (diff)
downloadmiragextract-e7c665d3c43fcad0f2e3f893b633f44c8fb18a38.tar.gz
0.0.1 release
Diffstat (limited to 'README')
-rw-r--r--README33
1 files changed, 30 insertions, 3 deletions
diff --git a/README b/README
index 6369c03..48b0f0f 100644
--- a/README
+++ b/README
@@ -7,11 +7,25 @@ Extracts data and audio tracks from any CD image supported by libmirage.
Data tracks are written as-is, and audio tracks can be written as-is
or converted to wav, flag, or ogg/vorbis (via libsndfile).
-Installing
-----------
+Prerequisites
+-------------
Requires GNU make, libmirage >= 3.0.0 and libsndfile (tested with 1.0.26,
-other recent-ish versions should work).
+other recent-ish versions should work). Since libmirage uses glib2,
+you'll need that as well.
+For libsndfile to create flac and ogg files, it has to have been
+built with support for them, which should only be a concern if you're
+building libsndfile yourself (distro packages should have ogg/flac
+support already).
+
+If you're on a system that has separate "dev" or "devel" packages
+(e.g. libmirage and libmirage-dev), you'll want the "dev" packages.
+
+If you for some reason need to rebuild the man and html pages, you'll
+need docutils (I used 0.14).
+
+Installation
+------------
To build, run "make" (might be spelled "gmake" on your OS). To install,
"make install". Near the top of the Makefile are some variables you
can override on the make command line to control where everything gets
@@ -65,3 +79,16 @@ http://urchlay.naptime.net/repos/miragextract/
If this doesn't help, contact me by email (see above) and I'll see what
I can do.
+
+Acknowledgments
+---------------
+The idea for miragextract came from John Oyler, who asked "Why do I
+need separate utilities for all these different CD image formats? Why
+couldn't there be a single tool that knows them all?"
+
+miragextract stands on the shoulders of giants:
+
+Erik de Castro Lopo is the main author of libsndfile, along with a long
+list of contributors.
+
+Rok Mandeljc and Henrik Stokseth are the authors of libmirage.