X-Git-Url: https://git.armaanb.net/?a=blobdiff_plain;f=README.md;h=d51ee1218369c29384bc1ae3d157d82f17545b2c;hb=0875b7849485bd43f677cb08e2193178c0eecf5e;hp=b9250f9ddbc9ff65017e25885c8fb90f600d6483;hpb=691525d47e162525a9f0a179c02dab493cbea940;p=lightcards.git

diff --git a/README.md b/README.md
index b9250f9..d51ee12 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,35 @@
 # lightcards
 Terminal flashcards from Markdown.
 
-# Installation
-`make`
+## Installation
+Lightcards is only tested and maintained on Linux. Support for other Unix-like operating systems such as MacOS and the various BSDs is likely, although untested. Windows support may be possible with [windows-curses](https://pypi.org/project/windows-curses/) or the like, however much of the program makes the assumption that there is a Unix-like file hierarchy, which may break on Windows. Nontrivial patches will not be accepted to improve Windows support, although may be for MacOS or BSD.
 
-# Usage
-see `lightcards --help`
+Lightcards requires Python 3.9
+
+### From PyPI
+```
+pip install lightcards
+```
+
+### From Git
+#### Main branch (stable)
+```
+pip install git+https://git.sr.ht/~armaan/lightcards
+```
+
+#### Development branch
+```
+pip install git+https://git.sr.ht/~armaan/lightcards@devel
+```
+
+## Usage
+See `lightcards --help` or `man lightcards` for usage information.
+
+## Input file
+`contrib/example.md` is an example input file. Lightcards takes the first table from a valid Markdown or HTML file. Each row is a card, and the two columns are the front and back.
+
+## Configuration
+Copy the config file at `/etc/lightcards/config.py` to `~/.config/lightcards/config.py` or `~/${XDG_CONFIG_HOME}/lightcards/config.py` and edit.
 
 ## License
 Copyright Armaan Bhojwani 2021, MIT license