https://github.com/engineervix/opensuse-setup

Opinionated openSUSE Tumbleweed dev environment setup with Hyprland
https://github.com/engineervix/opensuse-setup

hyprland opensuse-tumbleweed

Last synced: 19 days ago
JSON representation

Opinionated openSUSE Tumbleweed dev environment setup with Hyprland

• Host: GitHub
• URL: https://github.com/engineervix/opensuse-setup
• Owner: engineervix
• License: mit
• Created: 2026-03-23T19:52:01.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-05-14T06:51:03.000Z (20 days ago)
• Last Synced: 2026-05-14T08:36:55.098Z (20 days ago)
• Topics: hyprland, opensuse-tumbleweed
• Language: Shell
• Homepage:
• Size: 125 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# openSUSE Tumbleweed Developer Setup

![openSUSE](https://img.shields.io/badge/openSUSE-%2364B345?style=for-the-badge&logo=openSUSE&logoColor=white)

![Bash Script](https://img.shields.io/badge/bash_script-%23121011.svg?style=for-the-badge&logo=gnu-bash&logoColor=white)

[![ShellCheck](https://github.com/engineervix/opensuse-setup/actions/workflows/main.yml/badge.svg)](https://github.com/engineervix/opensuse-setup/actions/workflows/main.yml)

Automated setup script for openSUSE Tumbleweed, configuring a complete Hyprland-based development environment with modern tools, editors, and applications.

## Stack

A modular script architecture designed for a minimal Tumbleweed installation (Generic Desktop system role). It establishes a pure Wayland development environment using:

| Component | Choice |

| :--- | :--- |

| **Compositor** | Hyprland |

| **Status Bar** | Waybar |

| **Launcher** | Rofi |

| **Terminal** | Kitty |

| **Editor** | Neovim (Kickstart-based) |

See [docs/details.md](docs/details.md) for a full breakdown of packages, configurations, and architectural decisions.

## Installation

```bash

git clone https://github.com/engineervix/opensuse-setup.git

cd opensuse-setup

chmod +x install.sh scripts/*.sh

./install.sh

```

The setup runs six modular phases in sequence: System, Packages, Tooling, Fonts, Terminal, Dotfiles.

The script is interactive — it prompts for hostname, Git identity, and (in the Dotfiles phase) your dotfiles repository URL.

## Post-Installation

1. **Spotify:** Run `spotify-easyrpm` to complete the Spotify installation.

2. **Reboot:** Essential to finalize group permissions (Docker) and start your Hyprland session via SDDM.

## References

- [Official openSUSE Documentation](https://en.opensuse.org/Main_Page)

- [Hyprland Wiki](https://wiki.hyprland.org/)