starred/komorebi
1
0
Fork 0
mirror of https://github.com/LGUG2Z/komorebi.git synced 2026-01-11 14:40:25 +01:00
Code Issues 87 Packages Projects Releases 10 Wiki Activity

Walkthrough Videos / Blog Posts #17

New Issue
Closed
opened 2026-01-05 14:47:40 +01:00 by adam · 19 comments
adam commented 2026-01-05 14:47:40 +01:00
Owner
Copy Link

Originally created by @LGUG2Z on GitHub (Aug 24, 2021).

It would be nice to have videos or blog posts (any in language) of people walking through their configurations and showing their workflows using komorebi. These could all be added to a "Media" section in either the readme or on the project Wiki.

Since these kinds of walkthroughs are always more approachable than a big README.md, I think it would go a long way to improving the onboarding for potential new users who are interested in trying out a tiling window manager on Windows 10+.

If you have produced any content like this about komorebi and come across this issue, share a link here so that I can get it added to the documentation for more people to see.

Originally created by @LGUG2Z on GitHub (Aug 24, 2021). It would be nice to have videos or blog posts (any in language) of people walking through their configurations and showing their workflows using `komorebi`. These could all be added to a "Media" section in either the readme or on the project Wiki. Since these kinds of walkthroughs are always more approachable than a big `README.md`, I think it would go a long way to improving the onboarding for potential new users who are interested in trying out a tiling window manager on Windows 10+. If you have produced any content like this about `komorebi` and come across this issue, share a link here so that I can get it added to the documentation for more people to see.
adam added the documentation label 2026-01-05 14:47:40 +01:00
adam closed this issue 2026-01-05 14:47:41 +01:00
adam commented 2026-01-05 14:47:41 +01:00
Author
Owner
Copy Link

@worldofgeese commented on GitHub (Dec 16, 2021):

Just as an example of new user confusion, I still don't understand how to manage multiple monitors and their workspaces despite setting

; Ensure there are 3 workspaces created on monitor 1
Run, komorebic.exe ensure-workspaces 1 3, , Hide

On the secondary monitor and attempting to create a bind for send-to-monitor 1,

@worldofgeese commented on GitHub (Dec 16, 2021): Just as an example of new user confusion, I still don't understand how to manage multiple monitors and their workspaces despite setting ``` ; Ensure there are 3 workspaces created on monitor 1 Run, komorebic.exe ensure-workspaces 1 3, , Hide ``` On the secondary monitor and attempting to create a bind for `send-to-monitor 1`,
adam commented 2026-01-05 14:47:41 +01:00
Author
Owner
Copy Link

@snide commented on GitHub (Jun 14, 2022):

Hey. I'll sign up for this. I just found komorebi today and am absolutely thankful that it exists after coming from I3 in Linux land. Give me a little time to learn the configuration files and then I'll try to post something up.

Here's some previous videos I made around similar geek-config applications

@snide commented on GitHub (Jun 14, 2022): Hey. I'll sign up for this. I just found komorebi today and am absolutely thankful that it exists after coming from I3 in Linux land. Give me a little time to learn the configuration files and then I'll try to post something up. Here's some previous videos I made around similar geek-config applications * NNN https://www.youtube.com/watch?v=-knZwdd1ScU * Flavours https://www.youtube.com/watch?v=y-GERsrhTkA
adam commented 2026-01-05 14:47:42 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (Jun 14, 2022):

Hey @snide! I'm very excited to see your video! Feel free to join the Discord to ask questions or open issues for anything that I can help with while you're getting familiar with the project. 🙏

Funnily enough, I also maintain an open-source Elasticsearch project, what a small world!

@LGUG2Z commented on GitHub (Jun 14, 2022): Hey @snide! I'm very excited to see your video! Feel free to join the Discord to ask questions or open issues for anything that I can help with while you're getting familiar with the project. 🙏 Funnily enough, I also maintain an open-source [Elasticsearch project](https://github.com/LGUG2Z/elasdx), what a small world!
adam commented 2026-01-05 14:47:42 +01:00
Author
Owner
Copy Link

@snide commented on GitHub (Jun 24, 2022):

Small update. Shot the video work last night. Will spend the weekend on editing and get this to you hopefully by Monday.

@snide commented on GitHub (Jun 24, 2022): Small update. Shot the video work last night. Will spend the weekend on editing and get this to you hopefully by Monday.
adam commented 2026-01-05 14:47:42 +01:00
Author
Owner
Copy Link

@namefailed commented on GitHub (Jul 19, 2022):

@snide poke

@namefailed commented on GitHub (Jul 19, 2022): @snide poke
adam commented 2026-01-05 14:47:42 +01:00
Author
Owner
Copy Link

@GOATS2K commented on GitHub (Sep 28, 2022):

This is the video in question.
https://youtu.be/bf0j4GpubXA?t=187

@GOATS2K commented on GitHub (Sep 28, 2022): This is the video in question. https://youtu.be/bf0j4GpubXA?t=187
adam commented 2026-01-05 14:47:42 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (Nov 14, 2022):

I have started doing YouTube livestreams on komorebi development which will hopefully showcase more and more of the more advanced features as they undergo development and refinement. If you'd like to be notified of future livestreams or when videos of past livestreams are made available you can subscribe and register for notifications.

@LGUG2Z commented on GitHub (Nov 14, 2022): I have started doing [YouTube livestreams](https://www.youtube.com/channel/UCeai3-do-9O4MNy9_xjO6mg) on `komorebi` development which will hopefully showcase more and more of the more advanced features as they undergo development and refinement. If you'd like to be notified of future livestreams or when videos of past livestreams are made available you can subscribe and register for notifications.
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@Rafael-Conde commented on GitHub (Nov 28, 2022):

I have started doing YouTube livestreams on komorebi development which will hopefully showcase more and more of the more advanced features as they undergo development and refinement. If you'd like to be notified of future livestreams or when videos of past livestreams are made available you can subscribe and register for notifications.

I started watching one of them and I liked it! I couldn't make it to the end though, I'll finish it later.

I have a suggestion but maybe it's just me being lazy. I would really like to start using komorebi on a daily basis, it's the first window manager I use so the experience is still suboptimal due to my lack of experience. I think that it would help me if there was a config file with shortcuts to all komorebi functions. I believe I'm just being lazy, but not having to deal with configuration up front would allow me to just use it before trying to make it fit my personal pereferences.

The current sample in the repo is actually pretty good in my opinion, it might be that people that uses window managers with shortcuts would also likely use vim/neovim too, so I really appreciate the sample, I already used it for a bit and I could do a lot with it. Despite of that, I think I couldn't laverage the whole potential of komorebi.

I understand that this issue is supposed to help in that regard, but since I didn't see it explicitly mentioned in this thread I thought I could highlight it.

@Rafael-Conde commented on GitHub (Nov 28, 2022): > I have started doing [YouTube livestreams](https://www.youtube.com/channel/UCeai3-do-9O4MNy9_xjO6mg) on `komorebi` development which will hopefully showcase more and more of the more advanced features as they undergo development and refinement. If you'd like to be notified of future livestreams or when videos of past livestreams are made available you can subscribe and register for notifications. I started watching one of them and I liked it! I couldn't make it to the end though, I'll finish it later. I have a suggestion but maybe it's just me being lazy. I would really like to start using komorebi on a daily basis, it's the first window manager I use so the experience is still suboptimal due to my lack of experience. I think that it would help me if there was a config file with shortcuts to all komorebi functions. I believe I'm just being lazy, but not having to deal with configuration up front would allow me to just use it before trying to make it fit my personal pereferences. The current sample in the repo is actually pretty good in my opinion, it might be that people that uses window managers with shortcuts would also likely use vim/neovim too, so I really appreciate the sample, I already used it for a bit and I could do a lot with it. Despite of that, I think I couldn't laverage the whole potential of komorebi. I understand that this issue is supposed to help in that regard, but since I didn't see it explicitly mentioned in this thread I thought I could highlight it.
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (Nov 28, 2022):

Thanks for the feedback @Rafael-Conde! I will plan a livestream where I can interactively go through this file which contains all of the commands that you can bind to a key combination, show myself adding things from that file to the komorebi.ahk, explaining what each command does etc.

@LGUG2Z commented on GitHub (Nov 28, 2022): Thanks for the feedback @Rafael-Conde! I will plan a livestream where I can interactively go through [this file](https://github.com/LGUG2Z/komorebi/blob/master/komorebic.lib.ahk) which contains all of the commands that you can bind to a key combination, show myself adding things from that file to the `komorebi.ahk`, explaining what each command does etc.
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@Rafael-Conde commented on GitHub (Nov 29, 2022):

Thanks for the feedback @Rafael-Conde! I will plan a livestream where I can interactively go through this file which contains all of the commands that you can bind to a key combination, show myself adding things from that file to the komorebi.ahk, explaining what each command does etc.

That would be awesome @LGUG2Z ! One thing I believe I can do too is use your video and sort of turn it into a table with the commads, functionality and maybe even link the video timestamps into the table for reference and examples. Do you think it would help?

@Rafael-Conde commented on GitHub (Nov 29, 2022): > Thanks for the feedback @Rafael-Conde! I will plan a livestream where I can interactively go through [this file](https://github.com/LGUG2Z/komorebi/blob/master/komorebic.lib.ahk) which contains all of the commands that you can bind to a key combination, show myself adding things from that file to the `komorebi.ahk`, explaining what each command does etc. That would be awesome @LGUG2Z ! One thing I believe I can do too is use your video and sort of turn it into a table with the commads, functionality and maybe even link the video timestamps into the table for reference and examples. Do you think it would help?
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@NormTurtle commented on GitHub (Apr 16, 2023):

this file
404

@NormTurtle commented on GitHub (Apr 16, 2023): > [this file](https://github.com/LGUG2Z/komorebi/blob/master/komorebic.lib.ahk) 404
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (Apr 20, 2023):

https://www.youtube.com/watch?v=cBnLIwMtv8g quickstart walkthrough by me is now on YouTube! 🎉

@LGUG2Z commented on GitHub (Apr 20, 2023): https://www.youtube.com/watch?v=cBnLIwMtv8g quickstart walkthrough by me is now on YouTube! 🎉
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@d-r-a-b commented on GitHub (May 22, 2023):

Just found out about this project and it looks very interesting. The quickstart video was very informative!

One thing I noticed is that figuring out all the komorebic commands right now seems to boil down to looking at the configuration examples and using the komorebic command directly - did I miss a doc/blog post/video guide somewhere that covers these? It would be nice from the standpoint of a new user trying to get a more concrete sense of the features offered by a piece of software without having to first install that software. For example, I couldn't find anywhere that documents what monocle mode is, even if I could infer that it was probably a maximized window mode from the komorebi playlist videos. Seeing a set of "resize" maps in the example whkd config is the only reason I could guess that komorebi supports this, and I don't see any obvious way for a potential user to tell if there is the ability to dynamically create/destroy workspaces or to see all apps in a similar way to MacOS Expose/Windows Task View.

I spent 25 minutes looking for such docs, so this might be a personal problem but it is a datapoint relating to the onboarding experience. If such docs aren't available, new users would spend less time looking for the docs if there was a statement that such docs are a WIP/wishlist/unmaintainable item for now as komorebic is in active development and the only way to explore the features more in depth is to install and run komorebic or look through the source. I habitually prefer to install only software that I'm reasonably certain has the features to solve the problems I'm facing, perhaps as a side effect of the trauma of Windows registry/config file nightmares and a desire to reduce the malware attack surface inherent in installing more software packages. (Not saying that komorebi itself is any kind of security concern, but rather that a mindset of "install the software and find out" is not a good scalable solution and most users would be more secure if they did not just install any software package that hinted at solving their problem)

Funnily enough, the Chinese README does include a (non-comprehensive?) list of komorebic commands that succinctly provides a sense of komorebi features. Would you be open to a documentation PR that basically just translates that table to English and inserts it in the README?

@d-r-a-b commented on GitHub (May 22, 2023): Just found out about this project and it looks very interesting. The quickstart video was very informative! One thing I noticed is that figuring out all the `komorebic` commands right now seems to boil down to looking at the configuration examples and using the `komorebic` command directly - did I miss a doc/blog post/video guide somewhere that covers these? It would be nice from the standpoint of a new user trying to get a more concrete sense of the features offered by a piece of software without having to first install that software. For example, I couldn't find anywhere that documents what monocle mode is, even if I could infer that it was probably a maximized window mode from the komorebi playlist videos. Seeing a set of "resize" maps in the example `whkd` config is the only reason I could guess that komorebi supports this, and I don't see any obvious way for a potential user to tell if there is the ability to dynamically create/destroy workspaces or to see all apps in a similar way to MacOS Expose/Windows Task View. I spent 25 minutes looking for such docs, so this might be a personal problem but it is a datapoint relating to the onboarding experience. If such docs aren't available, new users would spend less time looking for the docs if there was a statement that such docs are a WIP/wishlist/unmaintainable item for now as `komorebic` is in active development and the only way to explore the features more in depth is to install and run komorebic or look through the source. I habitually prefer to install only software that I'm reasonably certain has the features to solve the problems I'm facing, perhaps as a side effect of the trauma of Windows registry/config file nightmares and a desire to reduce the malware attack surface inherent in installing more software packages. (Not saying that komorebi itself is any kind of security concern, but rather that a mindset of "install the software and find out" is not a good scalable solution and most users would be more secure if they did not just install any software package that hinted at solving their problem) Funnily enough, the Chinese README does include a (non-comprehensive?) list of `komorebic` commands that succinctly provides a sense of komorebi features. Would you be open to a documentation PR that basically just translates that table to English and inserts it in the README?
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (May 22, 2023):

The Chinese readme is actually based on an older version of the English readme. 😅

I agree with everything that you've said @d-r-a-b, and I think that we should redirect these efforts towards a project Wiki on GitHub, which has proven very beneficial for yabai.

I'm currently facing some health issues that limit the amount of time I can spend sitting at a computer, so I'm not in a position to take the lead on this, but the Wiki for the project is open and I encourage anyone who would like to contribute to the project to start adding pages using the yabai Wiki as a good reference model.

@LGUG2Z commented on GitHub (May 22, 2023): The Chinese readme is actually based on an older version of the English readme. 😅 I agree with everything that you've said @d-r-a-b, and I think that we should redirect these efforts towards a project Wiki on GitHub, which has proven [very beneficial for yabai](https://github.com/koekeishiya/yabai/wiki). I'm currently facing some health issues that limit the amount of time I can spend sitting at a computer, so I'm not in a position to take the lead on this, but the Wiki for the project is open and I encourage anyone who would like to contribute to the project to start adding pages using the `yabai` Wiki as a good reference model.
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@d-r-a-b commented on GitHub (May 23, 2023):

Sorry to hear about the health issues and hope they improve/become easier to manage with time. Thanks for the quick reply offering some direction on how contributors can help with this!

@d-r-a-b commented on GitHub (May 23, 2023): Sorry to hear about the health issues and hope they improve/become easier to manage with time. Thanks for the quick reply offering some direction on how contributors can help with this!
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (Nov 12, 2023):

I have added an auto-generated HTML version of the schema.json file for the static configuration format: https://komorebi.lgug2z.com/schema_doc

@LGUG2Z commented on GitHub (Nov 12, 2023): I have added an auto-generated HTML version of the `schema.json` file for the static configuration format: https://komorebi.lgug2z.com/schema_doc
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@goyalyashpal commented on GitHub (Jan 6, 2024):

I think that we should redirect these efforts towards a project Wiki on GitHub, which has proven very beneficial for yabai.
- @ LGUG2Z at https://github.com/LGUG2Z/komorebi/issues/18#issuecomment-1557412041

... have videos or blog posts (any in language) of people walking through their configurations and showing their workflows using komorebi ...
Since these kinds of walkthroughs are always more approachable than a big README.md,
- @ LGUG2Z at https://github.com/LGUG2Z/komorebi/issues/18#issue-977545277

i don't think that either of the proposed direction is good:

  • using community walkthroughs
  • using github wiki
  • for this purpose of "beginner oriented getting started guide"

to be clear, using community submissions on gh wiki is good idea - it's just not good (rather, very bad even) to use those for this purpose.

so, to make readme more approachable, i would propose to split readme in different sections.

i would be able to make a merge request for that if it's wanted 😃

@goyalyashpal commented on GitHub (Jan 6, 2024): > I think that we should redirect these efforts towards a project Wiki on GitHub, which has proven [very beneficial for yabai](https://github.com/koekeishiya/yabai/wiki). > \- @ LGUG2Z at https://github.com/LGUG2Z/komorebi/issues/18#issuecomment-1557412041 > ... have videos or blog posts (any in language) of people walking through their configurations and showing their workflows using `komorebi` ... > Since these kinds of walkthroughs are always more approachable than a big `README.md`, > \- @ LGUG2Z at https://github.com/LGUG2Z/komorebi/issues/18#issue-977545277 i don't think that either of the proposed direction is good: * using community walkthroughs * using github wiki * _for this purpose_ of "beginner oriented getting started guide" to be clear, using community submissions on gh wiki is good idea - it's just not good (rather, very bad even) to use those for this purpose. ---- so, to make readme more approachable, i would propose to split readme in different sections. i would be able to make a merge request for that if it's wanted :smiley: <!-- i don't have an extensive historic knowledge of purpose of readme's - some projects use it as their full documentation, others keep it lean & defer to other files for more detailed treatment. -->
adam commented 2026-01-05 14:47:43 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (May 2, 2024):

This is probably the best walkthrough video I've seen so far made by Olge on Discord!

https://www.youtube.com/watch?v=0LCbS_gm0RA

@LGUG2Z commented on GitHub (May 2, 2024): This is probably the best walkthrough video I've seen so far made by Olge on Discord! https://www.youtube.com/watch?v=0LCbS_gm0RA
adam commented 2026-01-05 14:47:44 +01:00
Author
Owner
Copy Link

@LGUG2Z commented on GitHub (Jan 4, 2025):

I'm going to close and unpin this issue now that we have https://github.com/LGUG2Z/awesome-komorebi 🎉

@LGUG2Z commented on GitHub (Jan 4, 2025): I'm going to close and unpin this issue now that we have https://github.com/LGUG2Z/awesome-komorebi 🎉
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
0.1.36
apps-behaving-badly
bug
bug
cannot-reproduce
documentation
enhancement
github_actions
i-am-stuck
i-will-definitely-work-on-this
i-will-not-work-on-this
i-will-probably-work-on-this
komorebi
komorebi-bar
komorebic
performance
pull-request
Mirrored from GitHub Pull Request
 translation
No Label documentation
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/komorebi#17
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?