https://github.com/werererer/japokwm

A wlroots and dwl based tiling wayland compositor based around creating layouts
https://github.com/werererer/japokwm

tiling wayland wayland-compositor wlroots

Last synced: about 2 months ago
JSON representation

A wlroots and dwl based tiling wayland compositor based around creating layouts

• Host: GitHub
• URL: https://github.com/werererer/japokwm
• Owner: werererer
• License: bsd-2-clause
• Created: 2020-09-20T22:06:29.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-01-15T16:15:45.000Z (8 months ago)
• Last Synced: 2024-07-01T18:24:57.990Z (3 months ago)
• Topics: tiling, wayland, wayland-compositor, wlroots
• Language: C
• Homepage:
• Size: 18.8 MB
• Stars: 135
• Watchers: 4
• Forks: 3
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  
Japokwm

  


    

      

    

  





  


    

  

  


    Japokwm is a dynamic tiling Wayland compositor that empowers you to create stunning layouts with ease.

  

  


    

      Logo designed by @werererer

    

  



😃 Ready to show your window manager who's in charge?

Japokwm is a dynamic tiling Wayland compositor that makes it a breeze to create custom layouts with a simple configuration. 🚀 You determine where the windows should go, and Japokwm handles the rest, allowing you to sit back, relax, and enjoy the view. 🌟

✨ **Join the japokwm Community!**  

🌐 [Subreddit](https://www.reddit.com/r/japokwm) | 💬 [Discord](https://discord.gg/WpGjAU393M)

# Table of contents

- [✨ Features:](#-features)

- [Distribution Packages 📦](#distribution-packages-)

- [Known Challenges and Opportunities for Improvement](#known-challenges-and-opportunities-for-improvement)

- [🚀 TODO](#-todo)

- [🙌 Acknowledgements](#-acknowledgements)

# ✨ Features:

- Gaps! ✨

- Damage Tracking 🛠️

- Layout specific configs 📝

- A client to control the window manager from the terminal - japokmsg, based on swaymsg 💼

- A dwm-based tagging system instead of normal (boring) tags 🏷️

- Create any layout you want with a 3-dimensional Array:

  ![Edit Layout](edit_layout.gif)

🚀 **Get Ready to Elevate Your Desktop Experience!** 🚀

Follow these simple steps to supercharge your desktop with the amazing Japokw, window manager:

1. 🏗️ **Building Japokwm** 🏗️

   - First, unleash the power of Japokwm by building it. Execute the following commands:

   

     ```sh

     meson build

     cd build

     meson compile

     meson install

     ```

   

2. ✨ **Get Ready for the Magic!** ✨

   - Now that Japokwm is all set up, get ready for an incredible desktop transformation!

3. 🪄 **Unleash Japokwm** 🪄

   - The moment you've been waiting for! Simply type:

   

     ```sh

     japokwm

     ```

And there you have it! 🎉 JapokWM will take your desktop experience to the next level with its powerful features and sleek design. Enjoy a whole new world of productivity and aesthetics! 🌟🖥️💯

# Distribution Packages 📦

[AUR](https://aur.archlinux.org/packages/japokwm-git) (May be out of Date, Git is better maintained 🔄)

# Known Challenges and Opportunities for Improvement

Since version 0.3, this project has entered its beta stage 🐞, where the primary focus is on bug fixes 🛠️. While some bugs may still emerge, they are far less common than in the alpha stage. If you come across any issues, please report them here, and together we'll make Japokwm even better! 🚀

# 🚀 TODO

Polish program and syntax for configuring 💎

# 🙌 Acknowledgements

Japokwm forked dwl and uses wlroots and parts of sway to do the heavy lifting 🪶