https://github.com/madladsquad/untitleddesktopbootstrap

A repository containing the tools needed to bootstrap the UntitledDesktopEnvironment
https://github.com/madladsquad/untitleddesktopbootstrap

shell-script utility

Last synced: about 12 hours ago
JSON representation

A repository containing the tools needed to bootstrap the UntitledDesktopEnvironment

• Host: GitHub
• URL: https://github.com/madladsquad/untitleddesktopbootstrap
• Owner: MadLadSquad
• License: mit
• Created: 2023-03-06T16:10:48.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-10-24T19:32:47.000Z (21 days ago)
• Last Synced: 2024-10-26T06:11:57.116Z (20 days ago)
• Topics: shell-script, utility
• Language: Shell
• Homepage: https://madladsquad.com/
• Size: 28.3 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# UntitledDesktopBootstrap

[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)

[![trello](https://img.shields.io/badge/Trello-UDE-blue])](https://trello.com/b/HmfuRY2K/untitleddesktop)

[![Discord](https://img.shields.io/discord/717037253292982315.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/4wgH8ZE)

A repository containing the tools needed to bootstrap the UntitledDesktopEnvironment

## Documentation

### setup

The `setup` script should be run when first installing the desktop. The script creates all required directories, copies `xinitrc`

and `Xft.xrdb` to `$XDG_CONFIG_DIRS[0]` as well as the `ude-setup-user-dirs` and `ude-setup-xdg-global` to `/usr/bin`. It also

runs `ude-setup-xdg-global`.

The first CLI argument is an installation prefix that can be used by a package manager to install to a sandboxed temporary root,

like portage's `$ED`

### ude-setup-xdg-global

Creates and exports global 

[XDG Base directories environment](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) variables.

### ude-setup-user-dirs

Updates the XDG User directories, creates legacy home directories like `.themes` and `.icons` and exports the home 

[XDG Base directories environment](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) variables.

### Xft.xrdb

Fallback resource settings for X11 applications, `.Xresources` overrides them

### xinitrc

Sets desktop session environment variables, runs `ude-setup-xdg-global` and `ude-setup-user-dirs`, loads X11 resources, user

keyboard layouts and launches the UDE session(currently not implemented)

### Dependencies

This scripts depends on the following applications:

1. `xrdb`

1. `xdg-user-dirs-update`

1. `xorg`