Awesome
PersonKanban
A lightweight personal Kanban board for everyday use.
You also can create, delete, and navigate around collections of boards call MetaBoards.
Personal Kanban also has a CommandBar to run special commands.
There is also a QuickBar to quickly add new items like boards, lists, and items.
It is currently a working Beta project with many of the planned features in place. I am currently using it daily to track my projects and bugs. It is currently a complete keyboard program without any drag & drop features. The keyboard hotkeys work similarly to NeoVim and Vim modal systems. But, in the Personal Kanban program, the cursor (highlighted lists or items and tabs for the boards) control the action of each key.
Table of Contents
- How to Build
- Installing from Releases
- How to Use
- Hot Keys
- Planned Features
- My Different Open Source Projects
How to Build
It is built using Wails 2 and Go. Once they are installed on your system, you can run it using:
rm -R build
mkdir build
cp image/appicon.png build
wails dev
or you can use the Maskfile to run Mask scripts:
rm -R build
mkdir build
cp image/appicon.png build
mask dev
To run the developmental environment. To make a full binary build, you need to run:
rm -R build
mkdir build
cp image/appicon.png build
wails build
I recommend that you can use the Maskfile to run Mask scripts:
mask build
Just remember, this is beta quality software at the moment. Use at your own risk. Also, the mask build currently creates a universal build on macOS. I haven't built and tried this software on any other platform. It should work as is on Linux, but I haven't really tried it yet.
Installing from Releases
You can also download the latest release on the release page. I currently only have a macOS M1/M2/M3 build. It will say that it is from a unknown developer. You just have to give it permission in order to use it. I write programs for my personal use and anyone that wants to use them. Since I'm not making money with it, I don't want to spend the $100/year to have Apple to qualify it for general distribution. As with any free program you download, use it at your own risk. I so far haven't had any issues with this program. If you do or have any suggestions, please leave a comment on the discussion board.
How to Use
Working on it.
Hot Keys
The following are the keyboard assignments and what they do for each mode:
| Key | Just board selected | List is highlighted | Item in a list is highlighted | Item is open |
|---|---|---|---|---|
| a | Creates a new board | Creates a new list in the current board | Creates a new Item in the current List | Nothing |
| m | Moves the board to the next or previous tab location | Moves the list in the direction given next | move the item up and down the current list or to the previous or next list | Puts the cursor into the message input box. |
| x | Deletes the current board | Deletes the current list | Deletes the current Item | Nothing |
| j | Highlight the first list | Highlight the first Item | Move the cursor to the next Item down the list | Nothing |
| k | Nothing | Nothing | Move the current item up the list | Nothing |
| h | Move to the next board to the left | Move to the next list to the left | Move to the next list to the left with the item at the same count level highlighted | Nothing |
| l | Move to the next board to the right | Move to the next list to the right | Move to the next list to the right with the item at the same count level highlighted | Nothing |
| b | Go to the board number pressed before the b key. | Go to the board number pressed before the b key. | Go to the board number pressed before the b key. | Nothing |
| t | Open the Metaboard selector | Open the Metaboard selector | Open the Metaboard selector | Nothing |
| e | Edits the board name | Edits the list name | Nothing | If followed by a 't', the title is edited. If followed by a 'd', the description is edited. |
| s | Nothing | Nothing | Nothing | Save all changes and close the item edit dialog. |
| : | Opens the CommandBar | Opens the CommandBar | Opens the CommandBar | Nothing |
| Esc | Clear all highlights and just have the board selected. | Clear all highlights and just have the board selected. | Clear all highlights and just have the board selected. | Close the item edit dialog. |
| Enter | Nothing | Nothing | Opens the List Item that is highlighted for editing. | Nothing |
| Space | Opens the QuickBar to add a new board with a description separated by a |. | Opens the QuickBar to add a new list. | Opens the QuickBar to add a new item with a description separated by |. | Nothing |
| . | Repeats the last command | Repeats the last command. | Repeats the last command. | Nothing |
| 0-9 | Creates a multiple digit accumulator for the number of times to execute the next command. | Creates a multiple digit accumulator for the number of times to execute the next command. | Creates a multiple digit accumulator for the number of times to execute the next command. | Creates a multiple digit accumulator for the number of times to execute the next command. |
If a number key is pressed before a hot key is pressed, it is stored in the accumulator. When a hot key is pressed, then that action is performed the number of times that the accumulator has stored. For example, if you press '2l', you will move to the 2nd list to the right of the cursor or if no cursors are shown, then to the second board to the right of the current board. Be careful when using this combined with the 'x' or delete key! Pressing '99x' with just the list cursor highlighted will delete all your lists in the current board (Unless you have more than 99 lists)!
Planned features
The following is a list of the features I plan to add in no particular order. If you have a feature you would like to see, just let me know and I'll add it to the list.
Features to add
- Meta grouping of boards and moving between them. - done
- A quick entry ability to quickly add different items. - done
- Copying and pasting board or list setups to a new board or list.
- The ability to load themes from a GitHub repository and changing or creating themes.
- Add drag and drop with the mouse.
- Add keyboard hotkeys for editing an item. Currently you have to use the mouse and double click on things to add them. - done
- Add more apps for items. Currently there is only a todo list app.
- Command bar to see commands and actioning them. - done It is called the QuickBar.
- The ability for the user to add new commands and themes. Downloading commands from GitHub as well.
- The ability to change themes and create new themes.
- Create a way to do things with Personal Kanban from the command line.
- Add documentation on how to use Personal Kanban.
My Different Open Source Projects
EmailIt BullitenBoard ScriptBar Modal File Manager Personal Kanban