Fully functional sticky notes App in your Terminal! Built with Textual, an amazing TUI framework!
- You can change background color now!
- JSON is saved with indent
- Focus bug fixes
- Fixed bug that you can't create new Note with some key bindings if there is no notes yet
Best option to install is using pipx:
pipx install notesh
# but it is still possible to do it with just pip:
pip install notesh
To start using just type in your terminal:
notesh
it will create new file notes.json in current directory.
You can also specify file by using -f
flag:
notesh -f MyNotes.json
# or full/relative path
notesh -f ~/Documents/MyNotes.json
- To create new note just press
Ctrl+A
- You can change color with buttons but also using scroll
- To edit note just click in its body
- To move note grab it top part and move with mouse
- To resize grab left bottom corner and move with mouse
- If you make make background to big it will readjust after you reopen App
- You can also click
CTRL-Mouse
to look around whole wall
You can now do everything using KEYBOARD!
This is first version so if you have any suggestions please write them in existing issue.
Default keybindings are in default_bindings.toml
file that is in root of installation.
You can also create second file user_bindings.toml
where you can overwrite defaults.
- Change focus
focus_next/focus_previous
usingctrl+i,ctrl+j/ctrl+o,ctrl+k
- Edit note
edit
usingi
- When note is focused you can move it with
j/k/l/h
. Also adding shift moves it more with one click - Clicking
unfocus
usingescape
returns from edit mode, and unfocus drawable if not in edit mode. - Resize note using
+/-
for vertical and>/<
for horizontal - Bring 'ctrl+f' Forward and
ctrl+b
Backward Note
Default file
# These are default, they also are displayed at the footer
[default]
quit = ["ctrl+q,ctrl+c", "Quit"]
toggle_sidebar_left = ["ctrl+e", "Sidebar Left"]
add_note = ["ctrl+a", "Create Stick Note"]
add_box = ["ctrl+x", "Create Box"]
save_notes = ["ctrl+s", "Save Notes"]
unfocus = ["escape", "Unfocus"]
"app.toggle_dark" = ["ctrl+t", "Dark/Light"]
[moving_drawables]
# Default movement
left = "h"
right = "l"
up = "k"
down = "j"
# You can add number after _ and it will move note that many times
left_5 = "H"
right_5 = "L"
up_5 = "K"
down_5 = "J"
[normal_insert]
# there is only `next` and `previous` and the order is not changable yet
focus_next = "ctrl+i,ctrl+j"
focus_previous = "ctrl+o,ctrl+k"
unfocus = "escape"
[normal]
edit = "i"
delete = "Q"
add_note = "o"
add_box = "O"
# For special characters like `+` or `<` you need to use names
# You can check the name using textual `textual keys`
[resize_drawable]
h_plus = "greater_than_sign"
h_minus = "less_than_sign"
v_plus = "plus"
v_minus = "minus"
# It brings at the top or bottom the note
[bring_drawable]
forward = "ctrl+f"
backward = "ctrl+b"
By default you can use ctrl+e
to open Left Slidebar:
There are many thigs to add! If you have idea, please create Issue with your suggestions.
- Safe saving (now if there are any bugs you may lost your notes)
- Vim Key bindings
- Wait for feedback
- Duplicate Note
- Hiding menu (Color Picker etc.)
- TOML config file
- Left Sidebar (for background and preferences)
- Background color
- Align tool for text
- Fixed layers (if needed)
- Diffrent Drawables:
- Check List
- Arrows
and also resolve problems:
- Multiline Input (currently textual does not support it and here we have my hacky solution)
Big thanks to Will McGugan and all members and contributors of Textualize.io! Go checkout Textual amazing TUI framework on which this app is based.