From b5e828d87576c4206ee10151f6697ad9435f72f1 Mon Sep 17 00:00:00 2001
From: "Jason A. Donenfeld" <Jason@zx2c4.com>
Date: Mon, 20 Aug 2012 21:27:46 +0200
Subject: Import blog to readme

---
 README.md                |  40 ++++++++++++++++++++++++++++++++++++++++
 README.mkd               |  25 -------------------------
 music-file-organizer.png | Bin 0 -> 498633 bytes
 3 files changed, 40 insertions(+), 25 deletions(-)
 create mode 100644 README.md
 delete mode 100644 README.mkd
 create mode 100644 music-file-organizer.png

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ad2671b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# Music File Organizer
+
+## Introduction
+
+I've been using this utility since I wrote it 6 years ago, and this afternoon, I cleaned up the code base in order to release it. It's a simple command-line music file organizer. It takes a list of files or directories as program arguments, inspects the tags of all the enclosed music files, and then determines which directories need to be created and what the music file name should be. Plenty of GUI tools do this already, many of which are very customizable, but I have yet to see a command-line utility as simple as this that gets the job done.
+
+The general ingestion routine for acquiring music on the Interwebs is I load it up in <a href="http://musicbrainz.org/doc/MusicBrainz_Picard/">Picard</a> or <a href="http://easytag.sourceforge.net/">EasyTag</a> or another command line utility to adjust the tags, and then run:
+
+    $ organizemusic ~/Downloads/some-silly-m4a-directory
+
+And presto, all the music is moved into the right place.
+
+<img src="music-file-organizer.png" />
+
+It takes care of translating difficult non ASCII character into correct transliterations using <a href="http://site.icu-project.org/">libicu</a> and uses KDE Scott Wheeler's <a href="http://taglib.github.com/">taglib</a> for the audio file tag reading.
+
+## Utilities
+
+This project ships two very simple utilities for organizing music files.
+
+### `organizemusic`
+This scans recursively all directories and files given as arguments and determines the tags of the audio files. It uses these tags to generate a file name and directory sstructure, normalizes the name to remove non ASCII characters, and then moves the files to their new location inside `$MUSICDIR` or `$HOME/Music`.
+
+    $ organizemusic ~/Downloads/Some-Torrent-Directory/ ~/Desktop/file-from-friend.mp3
+
+
+### `readmusictags`
+This spits out all the tag data inside the music files given as arguments.
+
+    $ readmusictags ~/some-music-file.flac ~/files/another_music-file.wma
+
+## Build Requirements
+
+* taglib - http://taglib.github.com/
+* libicu - http://site.icu-project.org/
+
+
+## Build Instructions
+
+    $ make
diff --git a/README.mkd b/README.mkd
deleted file mode 100644
index 71e0931..0000000
--- a/README.mkd
+++ /dev/null
@@ -1,25 +0,0 @@
-Music File Organizer
-====================
-
-This project ships two very simple utilities for organizing music files.
-
-### `organizemusic`
-This scans recursively all directories and files given as arguments and determines the tags of the audio files. It uses these tags to generate a file name and directory sstructure, normalizes the name to remove non ASCII characters, and then moves the files to their new location inside `$MUSICDIR` or `$HOME/Music`.
-
-``$ organizemusic ~/Downloads/Some-Torrent-Directory/ ~/Desktop/file-from-friend.mp3``
-
-
-### `readmusictags`
-This spits out all the tag data inside the music files given as arguments.
-
-``$ readmusictags ~/some-music-file.flac ~/files/another_music-file.wma``
-
-Build Requirements
-------------------
-* taglib - http://taglib.github.com/
-* libicu - http://site.icu-project.org/
-
-
-Build Instructions
-------------------
-`$ make`
diff --git a/music-file-organizer.png b/music-file-organizer.png
new file mode 100644
index 0000000..c3019e8
Binary files /dev/null and b/music-file-organizer.png differ
-- 
cgit v1.2.3-59-g8ed1b