feat: add README and LICENSE

3 files changed, 66 insertions, 0 deletions

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..d3061a3
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,13 @@
+Zero-Clause BSD
+=============
+
+Permission to use, copy, modify, and/or distribute this software for
+any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
+FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
+DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..882adec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# `mic-icon`
+
+![GIF of mic-icon](assets/mic-icon.gif)
+
+It's [`volumeicon`](https://github.com/Maato/volumeicon) for microphones! but, it sucks and it's written in an inferior languange 😅. Only works on Linux (sorry, I'm honestly incompetent with other OSs).
+
+In this modern internet dystopia, I often share my screen and disable notifications when presenting. This means that I don't get to see my "Microphone is [STATE]" notifications when sharing (I do tend to mute a fair bit for coughs). Imagine muting and forgetting to unmute as you continue to speak… OOOOH!!! THE MODERN SHAME!! 😭. 
+
+With that spiel said, I just needed something that aims to be a "lightweight mic status indicator that sits in your systray" and here it is… TADA! just like `volumeicon` it's `mic-icon`!
+
+I really just wrote this for myself and sharing it on the internet 🤷‍♂️.
+
+## Dependencies
+
+* Python 3
+    * this thing is so simple I'll be suprised if we're facing any version incompatibilities already
+* `pulsectl`
+* `pygobject`
+* `pactl` command (part of the `pulseAudio` or `pipewire-pulse` packages)
+* GTK 3.0 (via your system package manager)
+* AppIndicator3 (via your system package manager)
+
+## Installation
+
+virtualenv is the way!
+
+```sh
+python -m venv .venv
+```
+
+then activate the `venv`…
+
+```sh
+source .venv/bin/activate
+```
+
+(if you're a fish user, it would be  `source .venv/bin/activate.fish` 😉)
+
+then…
+
+```sh
+pip install . 
+```
+
+then…
+
+```sh
+mic-icon
+```
+
+and now you have it! symlink that `./.venv/bin/mic-icon` sumbitch somewhere in your `PATH=` and run it on start-up — or however, the heck you want.
+
+![the rock says come bring it](https://media.tenor.com/GkY0BS3F0R4AAAAM/the-rock-just-bring-it.gif)
diff --git a/assets/mic-icon.gif b/assets/mic-icon.gif
new file mode 100644
index 0000000..b89d1ac
--- /dev/null
+++ b/assets/mic-icon.gif