https://github.com/axos-project/theom

An extremely hackable and resource friendly desktop environment built on top of i3wm
https://github.com/axos-project/theom

Last synced: 8 months ago
JSON representation

An extremely hackable and resource friendly desktop environment built on top of i3wm

• Host: GitHub
• URL: https://github.com/axos-project/theom
• Owner: AxOS-project
• License: gpl-3.0
• Created: 2025-05-09T05:14:57.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-15T10:46:20.000Z (about 1 year ago)
• Last Synced: 2025-06-15T11:47:55.278Z (about 1 year ago)
• Language: Shell
• Homepage:
• Size: 55.5 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# Theom

![CI](https://github.com/AxOS-project/Theom/actions/workflows/syntax.yml/badge.svg)

![License GPL3](https://img.shields.io/badge/License-GPL3-yellow.svg)

![Last commit](https://img.shields.io/github/last-commit/AxOS-project/Theom)

![Release](https://img.shields.io/github/v/release/AxOS-project/Theom)

**Theom** is an extremely lightweight desktop environment built on top of [i3wm](https://i3wm.org/) for [AxOS](https://www.axos-project.com/), designed for speed, simplicity, and elegance. Ideal for minimalists, power users, and systems where every megabyte matters.

## Features

- Minimal resource usage: 400-450MB ram use on idle (information from VM | minimal arch install)

- Comes with two different themes: a dark theme and a light theme

- Has a built in dashboard

- Has a settings application to tweak the settings of Theom

- Welcomes user with a friendly greeter during startup

- Has multiple animation modes: None, Minimal, Fancy

- Easy to customize

## Media

  All Media (click me)

### Videos

https://github.com/user-attachments/assets/d375fad4-aa67-46c7-b52b-64dcab6368f1

### Screenshots

![image](https://raw.githubusercontent.com/AxOS-project/Theom/main/screenshots/screenshot1.png)

![image](https://raw.githubusercontent.com/AxOS-project/Theom/main/screenshots/screenshot2.png)

![image](https://raw.githubusercontent.com/AxOS-project/Theom/main/screenshots/screenshot3.png)

![image](https://raw.githubusercontent.com/AxOS-project/Theom/main/screenshots/screenshot4.png)

![image](https://raw.githubusercontent.com/AxOS-project/Theom/main/screenshots/theom-bar.gif)

## Installation

- Install the latest version from the [releases](https://github.com/AxOS-project/Theom/releases) and run the following command.

```

sudo pacman -U 

```

- Or run the following command if you have [epsilon](https://github.com/AxOs-project/epsilon) installed.

```

epsi i theom

```

## Documentation

You can read the theom documentaiton that covers on how we can use/configure theom at: [theom - axos docs](https://www.axos-project.com/docs/guides/theom/)

## Dependencies

View the dependencies in [the deps.txt file](https://raw.githubusercontent.com/AxOS-project/Theom/main/deps.txt)

## Contributheoming

Do you want to contribute to theom? great! You can read our [CONTRIBUTING.md](https://github.com/AxOS-project/Theom/blob/main/CONTRIBUTING.md) to get started!

> [!NOTE]

> Any kind of contribution (code and non-code) is deeply appreciated.

## Credits

- [Wallpaper]() credits at [/src/bin/backgrounds/theom/README.md](https://github.com/AxOS-project/Theom/blob/main/src/share/backgrounds/theom/README.md)

- [User Interface](https://en.wikipedia.org/wiki/User_interface) inspired by [sleex](https://github.com/AxOS-project/Sleex)