summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMathias Fredriksson <mafredri@gmail.com>2022-02-07 20:50:53 +0200
committerMathias Fredriksson <mafredri@gmail.com>2022-02-07 20:54:51 +0200
commit6436c86e0c53d9fbd83d883f76cbd8a267b6428e (patch)
tree07f90e739d93b44a7247cfb84cabba7891389e31 /README.md
parentac3aa7fb134166afb5e159786db501e1e6b646fa (diff)
Implement initial PoC for Kodi
Diffstat (limited to 'README.md')
-rw-r--r--README.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0ba6fa6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# magic4linux
+
+Allows you to use the magic remote on your webOS LG TV as a keyboard/mouse for your ~~PC~~ Linux machine.
+
+This is a Linux implementation of the [Wouterdek/magic4pc](https://github.com/Wouterdek/magic4pc) client.
+
+A virtual keyboard and mouse is created via the `/dev/uinput` interface, as provided by the [bendahl/uinput](https://github.com/bendahl/uinput) library. For non-root usage, please add udev rules as instructed in the [`uinput`](https://github.com/bendahl/uinput#uinput-----) documentation.
+
+## Installation
+
+```shell
+go install github.com/mafredri/magic4linux/cmd/magic4linux
+```
+
+## Usage
+
+There are no options yet.
+
+```shell
+magic4linux
+```
+
+## Building for other platforms
+
+```shell
+git clone https://github.com/mafredri/magic4linux
+cd magic4linux/cmd/magic4linux
+GOOS=linux GOARCH=arm64 go build
+```