major usability improvements
Terminal now modal, supports line buffering, stdin, because it uses pty (and threading). Also supports paste, again (?). Audio player queueing no longer blocks, supports appending. Now can change window size. Halfscreen window shortcut improved. Eliminate dirs dep, deconstruct audiotags dep, better feature flags. Remove .alpha files because they are built. Use /home/jondough for default dirs if possible. Themes config. Fix for rotated touchscreen. Write more docs
This commit is contained in:
@@ -8,8 +8,9 @@ Type to write commands, backspace to delete last character, and enter to run com
|
||||
- `l`: Next/skip
|
||||
- `j`: Volume down
|
||||
- `k`: Volume up
|
||||
- `b <dir>`: Set base directory (`<dir>` is path)
|
||||
- `b <dir>`: Set base directory (`<dir>` is path). Unless paths are absolute, they will be relative to what the base directory currently is (by default, `$HOME` is set, `/` otherwise)
|
||||
- `p <dir / playlist file>`: Play audio files in `<dir>` or play the songs listed in the `<playlist file>`. Unless paths are absolute, they will be relative to the directory specified by the `b <dir>` command
|
||||
- `a <dir / playlist file>`: Same as `p` but appends to the end of the queue instead of clearing the current song and the queue
|
||||
|
||||
## Playlists
|
||||
|
||||
@@ -19,5 +20,8 @@ Example playlist file:
|
||||
hanyuu-maigo/オノマトペ
|
||||
inabakumori/*
|
||||
iyowa/*
|
||||
kai/さよならプリンセス
|
||||
such/Hegira
|
||||
```
|
||||
|
||||
If there is no file extension, the player assumes `.mp3`.
|
||||
|
||||
|
||||
@@ -19,3 +19,26 @@ r./bmps/castle1440x842.bmp
|
||||
r./bmps/ming1440x842.bmp
|
||||
r./bmps/blur1440x842.bmp
|
||||
```
|
||||
|
||||
## Unrelated: Themes Config
|
||||
|
||||
Not handled by the desktop background, but here anyways. To configure, create `$XDG_CONFIG_DIR/ming-wm/desktop-background`.
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
Standard
|
||||
Standard
|
||||
Standard
|
||||
Standard
|
||||
Standard
|
||||
Forest
|
||||
Royal
|
||||
Industrial
|
||||
Night
|
||||
```
|
||||
|
||||
This would set the first 5 workspaces to the Standard theme, with the 6th being Forest theme, 7th being Royal theme, 8th being Industrial theme, and the 9th being Night theme. Those are currently all the themes available. The Forest and Royal themes only differ from the Standard theme in their window decoration (the window top) colour.
|
||||
|
||||
Editing `/src/themes.rs` and re-compiling is the only way to make new themes. Feel free to open a PR if an especially pleasant theme is made.
|
||||
|
||||
|
||||
9
docs/window-likes/file-explorer.md
Normal file
9
docs/window-likes/file-explorer.md
Normal file
@@ -0,0 +1,9 @@
|
||||
Barebones file explorer.
|
||||
|
||||
## Navigation
|
||||
|
||||
- `j`: Move down
|
||||
- `k`: Move up
|
||||
- `i`: See info about current file / directory (press any key to escape info screen)
|
||||
- `Enter`: Go into directory
|
||||
|
||||
@@ -2,4 +2,5 @@ Shown when screen is locked. Unlocks the screen when correct password is entered
|
||||
|
||||
## Config
|
||||
|
||||
Before building, create a `password.txt` in the same directory as the `build.rs` file with the password.
|
||||
Before building, create a `password.txt` in the same directory as the `build.rs` file with the password. Remove the file after building.
|
||||
|
||||
|
||||
10
docs/window-likes/start-menu.md
Normal file
10
docs/window-likes/start-menu.md
Normal file
@@ -0,0 +1,10 @@
|
||||
The start menu, which can be opened and closed with the [Alt+s shortcut](../system/shortcuts.md).
|
||||
|
||||
## Navigation
|
||||
|
||||
Use the 'j' and 'k' keys to move down and up respectively. Going down past the last option returns the selection to the first option, and vice versa (it loops).
|
||||
|
||||
Hitting the 'enter' key will either open a subfolder containing window-likes, if a category is selected, or the corresponding window-like, if a window-like is selected. It may also exit a subfolder and return to the category selection if "Back" is selected and 'enter' is hit. There is another special case: hitting 'enter' while the "Logout" option is selected will, as the name implies, logout and return to the lock screen (this does not log out of the Linux user!).
|
||||
|
||||
For faster navigation, hitting any lower-case letter (besides 'j' and 'k') will move the selection to the next option that starts with that letter (non-looping). For example, when first opening the start menu, hitting 'e' will move the selection to "Editing". Hitting any upper-case letter will move the selection to any previous option that starts with that letter (also non-looping). For example, when initially opening the start menu, the selected option is "About". After hitting 'j' (moving down), hitting 'A' will return the selection to "About".
|
||||
|
||||
21
docs/window-likes/terminal.md
Normal file
21
docs/window-likes/terminal.md
Normal file
@@ -0,0 +1,21 @@
|
||||
A basic, line-buffered, modal terminal.
|
||||
|
||||
## Usage
|
||||
|
||||
The terminal displays the current mode in the lower left corner. The possible modes are "INPUT", "RUNNING", "STDIN".
|
||||
|
||||
The terminal starts off in INPUT mode, which allows entering commands to run. If `$HOME` is set, the starting directory is that. Otherwise, it is root (`/`).
|
||||
|
||||
In INPUT mode, commands can be freely typed. There are a few special control sequences:
|
||||
|
||||
- `ctrl+p`: Brings up the last run command to the command input
|
||||
- `ctrl+n`: Clears the command input
|
||||
|
||||
Once a command is entered, hit 'enter' to execute it. The terminal will change into "RUNNING" mode. In this mode, clicking any key except for 'i' will result in the terminal writing the current output of the running command to the window (`ctrl+c` will force the process to exit). It will also check if the command has exited, in which case the INPUT mode is returned to. Clicking the 'i' key will change the terminal to "STDIN" mode.
|
||||
|
||||
In STDIN mode, any keys typed followed by the 'enter' key will send those keys to the command's STDIN, if it is still running. To escape STDIN mode, use the `esc` key.
|
||||
|
||||
## Copy / Paste
|
||||
|
||||
This window-like supports the paste [shortcut](../system/shortcuts.md) (`Alt+P`) if in INPUT or STDIN mode.
|
||||
|
||||
Reference in New Issue
Block a user