diff --git a/INSTALL b/INSTALL.md
similarity index 54%
rename from INSTALL
rename to INSTALL.md
index f9f9e63..fcf44df 100644
--- a/INSTALL
+++ b/INSTALL.md
@@ -1,3 +1,5 @@
+# What/why/where to install things
+
 filter-repo only consists of a few files that need to be installed:
 
   * git-filter-repo
@@ -28,6 +30,8 @@ filter-repo only consists of a few files that need to be installed:
     version of the same page is provided for those who prefer it.  Place it
     where ever you like; I have no idea where such a thing should go.
 
+# Installation via Makefile
+
 Installing should be doable by hand, but a Makefile is provided for those
 that prefer it.  However, usage of the Makefile really requires overridding
 at least a couple of the directories with sane values, e.g.
@@ -36,4 +40,34 @@ at least a couple of the directories with sane values, e.g.
 
 Also, the Makefile will not edit the shebang line (the first line) of
 git-filter-repo if your python executable is not named "python3";
-you'll still need to do that yourself.
\ No newline at end of file
+you'll still need to do that yourself.
+
+# Installation via [pip](https://pip.pypa.io/)
+
+Coming soon; see [PR #16](https://github.com/newren/git-filter-repo/pull/16).
+Once it's in place, you'll be able to install via
+
+    $ pip3 install git-filter-repo
+
+
+# Installation via Package Manager
+
+There are [package
+managers](https://alternativeto.net/software/yellowdog-updater-modified/?license=opensource)
+for most operating systems; from
+[dnf](https://github.com/rpm-software-management/dnf) or
+[yum](http://yum.baseurl.org/) or
+[apt-get](https://www.debian.org/doc/manuals/debian-reference/ch02.en.html)
+or whatever for Linux, to [brew](https://brew.sh/) for Mac OS X, to
+[scoop](https://scoop.sh/) for Windows.  Nearly any of these tools
+will reduce the installation instructions down to
+
+    $ PACKAGE_TOOL install git-filter-repo
+
+I have no interest in tracking all these pre-built packages (nor
+whether those who packaged git-filter-repo have made modifications or
+left parts of it out), but apparently https://repology.org is willing
+to track who has packaged it.  So, using repology's packaging status
+link, the following package managers have packaged git-filter-repo:
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/git-filter-repo.svg)](https://repology.org/project/git-filter-repo/versions)
diff --git a/README.md b/README.md
index 2ecea07..2ee98ac 100644
--- a/README.md
+++ b/README.md
@@ -43,11 +43,11 @@ filter-repo requires:
 git-filter-repo is a single-file python script, which was done to make
 installation for basic use trivial: just copy it into your $PATH.
 
-See [INSTALL](INSTALL) for things beyond basic usage or special cases.
-The more involved instructions are needed if you
+See [INSTALL.md](INSTALL.md) for things beyond basic usage or special
+cases.  The more involved instructions are needed if you
 
   * are working with a python3 executable named something other than "python3"
-  * want to install documentation
+  * want to install documentation (beyond the builtin docs shown with -h)
   * want to run some of the [contrib](contrib/filter-repo-demos/) examples
   * want to create your own python filtering scripts using filter-repo as a
     module/library