Skip to content

Commit

Permalink
Cleaning out info pertaining to the desktop environment
Browse files Browse the repository at this point in the history
  • Loading branch information
mattkae committed Dec 28, 2023
1 parent 941dc56 commit 8e2ca5a
Showing 1 changed file with 20 additions and 40 deletions.
60 changes: 20 additions & 40 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,34 @@
**WARNING**: This project is very much a work in progress. I have provided a rough roadmap in the timeline section.
Use at your own risk.

# miracle
**miracle** is a _Mir_-based, Wayland desktop environment inspired by modern IDEs. The window manager intends
to provide a typical tiling window management experience (akin to i3 or sway). The shell focuses on usability for
programmers by being extendable and providing a JetBrains-inspried interface. While window managers like i3 and sway
are simple but barebones, miracle will provide a heavier out-of-the-box-solution that is geared towards making
the life of the average programmer happy and productive. If you like the lightweight nature of other IDEs, then this
one might not be for you. But if you want your desktop environment to provide a host of useful facilities at your
fingertips, then look no futher!
# miracle-wm
**miracle-wm** is a wayland tiling window manager based on [Mir](https://github.com/MirServer/mir). The tiling features
will be very sway/i3-like for the first iteration, but will diverge in some important ways later on. See the [timeline](#timeline)
section below for the current status and direction.

While **miracle** intends to be a full desktop environment, the tiling window management facilities will always
be provided as a standalone option so that you might use your own shell if you like.
The ultimate goal of this work is to build an entire desktop envrionment on top of this window manager, but that will remain a
concern for a different repository with a different timeline.

# Building
```
git clone https://github.com/mattkae/miracle.git
cd miracle
# Building locally
```sh
git clone https://github.com/mattkae/miracle-wm.git
cd miracle-wm

mkdir build
cd build
cmake ..
./bin/compositor
./bin/miracle-wm
```

# Building the snap
```sh
cd miracle-wm
snapcraft
sudo snap install --dangerous --classic miracle-wm_*.snap
```

# Timeline
## Tiling Window Manager (Due: January 1st)
## Tiling Window Manager Basics (Due: January 1st)
Version: 0.1

Features:
Expand All @@ -40,32 +43,9 @@ Features:
- [ ] Handle exclusion zones
- [ ] Handle output creation, updating, and deletion

## Tiling Advanced + Initial Shell (Due: February 1st)
## Tiling Advanced(Due: February 1st)
Version: 0.2

Features:
- [ ] Workspaces
- [ ] Moving windows between workspaces
- [ ] Launcher (Rust + GTK most likely)
- [ ] Favorite applications
- [ ] Opened applications
- [ ] Favorite folders
- [ ] Pinned scripts
- [ ] Top Panel
- [ ] Clock
- [ ] Battery indicator
- [ ] Wifi Indicator
- [ ] Lock Screen
- [ ] Weather

## Tiling More Advanced + Futher UI
Version: 0.3

Features:
- [ ] UI Cleanup
- [ ] UI Plugin Interface
- [ ] Configuration file
- [ ] Settings application
- [ ] Visual Sugar
- [ ] A workspace visualizer in the top panel (in-memory app)
- [ ] A tile visualizer in the top panel (in-memory app)

0 comments on commit 8e2ca5a

Please sign in to comment.