From d2b6b3060cfbeb17047f1fd1f989677f28f677eb Mon Sep 17 00:00:00 2001
From: twells46 <tom@wellsth.com>
Date: Sat, 7 Mar 2026 08:50:19 -0600
Subject: Initial commit

---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9717c3d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# Porch
+
+Step onto the `porch` and see the weather!
+
+## Usage
+
+First, place your OpenWeatherMap API key in `~/.config/porch/key.txt`.
+You can get one for free [here](https://openweathermap.org/).
+If you wish, you can place your home city in `~/.config/porch/defaultCity.txt`.
+
+To get weather for your default city (if set), run:
+
+```sh
+porch
+```
+
+To get weather for any city, run:
+
+```sh
+porch <city>
+```
+
+For example:
+
+```sh
+porch New York
+```
+
+`porch` can handle spaces in city names.
-- 
cgit v1.2.3