remote-i3wm-ws/README.md

61 lines
1.4 KiB
Markdown
Raw Permalink Normal View History

2023-08-26 12:22:35 +02:00
# **This project is abandoned. Please use https://gitnet.fr/deblan/remote-i3wm-go**
2023-08-26 12:22:21 +02:00
2018-02-05 10:07:30 +01:00
Remote i3-wm WS
===============
2018-02-06 10:29:06 +01:00
This project is a POC for managing a GNU/Linux desktop (with i3-wm). It implements an interface for running:
2018-02-05 10:07:30 +01:00
2018-02-06 10:29:06 +01:00
* `amixer`
* `i3-msg`
* `xdotool`
2018-02-07 11:15:57 +01:00
* `playerctl`
2018-02-09 17:41:31 +01:00
* `import`
2018-02-06 10:29:06 +01:00
It allows you to:
* change the i3-wm workspaces
* manage volume and spotify
* send text and shortcuts
2018-02-06 11:50:24 +01:00
* move the pointer, scroll and click
2018-02-09 17:22:44 +01:00
* make a screenshot and show the live screen
2018-02-06 10:29:06 +01:00
…by using a web interface with your phone.
2018-02-07 17:59:38 +01:00
![](https://upload.deblan.org/u/2018-02/5a7b3064.png)
2018-02-07 17:01:00 +01:00
![](https://upload.deblan.org/u/2018-02/5a7b2217.png)
![](https://upload.deblan.org/u/2018-02/5a7b221a.png)
![](https://upload.deblan.org/u/2018-02/5a7b221d.png)
2018-02-06 11:55:56 +01:00
Installation
------------
**Requirements**
* PHP7
* composer
```
$ git clone https://gitnet.fr/deblan/remote-i3wm-ws.git
$ cd remote-i3wm-ws/
$ cd client && composer install && cd ..
$ cd server && composer install && cd ..
$ php -S 0.0.0.0:15000 -t client/&
$ php server/src/resource/server.php
2018-02-06 11:55:56 +01:00
```
2018-02-12 15:40:31 +01:00
The server can be run with verbosity:
2018-02-08 12:56:53 +01:00
* `-v` or `--verbose` to show server messages
2022-04-11 18:29:44 +02:00
* `-m` or `--message` to show client messages
* `-b` or `--bind` to define server address to bind (default: `0.0.0.0`)
2018-02-08 12:56:53 +01:00
2018-02-06 11:55:56 +01:00
Open `http://your.local.ip:15000` and enjoy!
If you want to start/stop/restart the websocket easily:
```
$ export SERVER_OPTIONS="-v"
$ server/server start
$ server/server stop
$ server/server restart
```