Open-source project
diinki/linux-antiquity avatar
diinki/linux-antiquity

The author tells you to install it at your own risk, two applications are hard requirements, and you must edit the compositor config before it can show you anything

A highly tasteful Linux-theme, reminiscent of art-nouveau and old drawings related to astronomy, science, and mythology.

1,084 stars24 forksQMLMIT

At a glance

What is it?
A Hyprland desktop theme built on a Qt shell layer, with an art nouveau astronomy and mythology aesthetic. The candid warning block, the dependency list and the manual configuration steps are the honest parts of the page.
Who is it for?
This is an art project with a working installer, not a maintained desktop configuration, and the project is the first to say so. Read the warning before anything else: the stated purpose was a proof of concept for a video, a large refactor is planned, interface performance was explicitly not a design concern, there is one release, and the author asks you to reinstall often because that is how you get updates.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 77 days ago.
What is it written in?
Mainly QML, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 4, 2026, and from our analysis. They are not legal advice.

Editorial analysis

The warning block is the most useful text on the page

Before anything else the page carries a caution notice, and it is unusually specific about the project's own status.

The stated purpose is an art project, first and foremost, and as of version 0.1 the focus was to get a proof of concept finished and ready for a video about the theme. The notice then tells the reader plainly to install and use it at their own risk.

Three admissions follow. A lot of the code, described as a large portion, will be refactored after version 0.1, and a lot of the designs may change. Interface performance was not a concern in that version, and while it runs well for the author, it is not optimised. And the author asks anyone intending to use the theme to follow the repository so they hear about updates, recommending installation of the latest version often from the releases page.

The last line is the most revealing: the author describes himself as busy, and says he will try to improve and update the theme as much as he can since he intends to use it as his main theme.

So the maintenance story is: one person, one release, a refactor promised, and an update channel that is reinstalling from the releases page rather than anything versioned. That is a legitimate hobby project. It is not a configuration anyone else depends on, and the page does not pretend otherwise.

A terminal emulator and a file manager are requirements, not preferences

The dependency list is split into required and recommended, and the required column is where the coupling lives.

Two of the entries are annotated with the reason a theme would need them: a wallpaper daemon, and a screenshot utility for the screenshot keybinding. The shell layer that the repository's own primary language belongs to has a version floor, and the compositor has one too.

Then there are the two that matter.

A specific terminal emulator is listed, annotated as the terminal configuration it uses by default. A specific file manager is listed, annotated as the file explorer configuration it uses by default. Both are in the required column.

So installing this theme means adopting a particular terminal and a particular file manager, not merely liking a colour scheme. The annotations are phrased as defaults, which reads as a preference, but the placement under required is what a script checking for dependencies would act on.

Three more required entries carry no annotation at all: a notification daemon, a JSON processor, and a socket relay utility. A networking relay as a hard requirement of a desktop theme is the one a reader cannot account for from the page.

The recommended column is two entries, both for changing things the theme deliberately does not ship, and both pointing at the same helper application for interface styling plus a settings database.

The compositor version floor tracks a change of configuration language

The version requirement on the compositor is above 0.55, and the reason is written next to it: the project uses Lua now.

That single clause explains the whole floor. The compositor's own configuration language changed, and the theme's configuration moved with it. Every documented setup step points at a Lua file for the compositor settings and a configuration file for the wallpaper daemon, so the minimum version is a language requirement rather than a feature requirement.

The shell layer has its own floor, above 0.3.0, and it is the part written in the interface markup language that the repository records as its primary language. So the project's own code lives in the shell, and the configuration that a user has to edit by hand lives in the compositor's Lua file.

That split explains a structural observation about the keybindings. They are documented in the page as text pairs, a modifier plus a key, and the page points at the Lua file as the place to edit them. The prose notation is older than the file format it describes, which is harmless but means the list on the page is a summary of a file rather than the file itself.

Eleven bindings are listed, including the standard set for a terminal, a launcher, a file manager launcher, workspace switching, window movement between workspaces, a floating-mode toggle, killing a focused window and full screen, plus drag to resize and drag to move.

Monitor details are set by editing a file, and the settings menu has no monitor tab

The manual configuration section names three things that have to be done by hand for now: monitor details, wallpaper directories, and creating an account with a third-party weather service for the weather widget data.

The two files to edit are the compositor's Lua configuration and the wallpaper daemon's configuration file. The author says the files are commented in a detailed manner so it should not be hard to work out, which is a fair description and not a substitute for a settings screen.

This is the bootstrapping problem in miniature. You cannot see what a theme looks like on your display until the display's details are declared, and the declaration has to be written in a configuration file before the theme will render. A user who is installing a theme because they want a working desktop gets a text editor as the second step of the installation.

The author acknowledges the burden three separate times in the page. Once here, once for the icon theme, and once for the keybindings, each time noting that a settings menu would be better. The two later notes say a tab specifically for monitor data is being considered, and that making keybinding editing part of the settings menu is something he might do later. Neither exists yet.

The wallpaper directories are the same story. There is a configuration file for the wallpaper daemon, the theme ships wallpapers for several variants, and the choice of which goes on which monitor is made by editing the file.

One widget needs an account and one theme is set by uncommenting two lines

The two remaining manual steps are third-party coupling in different forms.

The weather widget is enabled through the theme's own settings menu, opened from buttons on the left side bar, where you input details for a commercial weather data service. The page notes that the service's free tier is generous enough for the widgets' needs. So a desktop theme acquires an account requirement and a rate-limited API call, and if that service changes its free tier or its terms, a widget in an otherwise local interface stops working with no change on the user's side.

The icon theme is a different kind of coupling, and it is a clever one. The theme ships its own icon theme, and to use a different one you edit the top lines of the shell's root file:

code
/* NOTE: CHANGE THESE IF YOU WANT TO USE A DIFFERENT ICON THEME:*/
//@ pragma IconTheme buuf-nestort
//@ pragma Env QS_ICON_THEME=buuf-nestort

Two lines, and the mechanism is a comment-based pragma. A reformat that strips comments, or a change to how the shell layer reads its directives, silently reverts the icon theme with no error. The page also asks you to place icon theme folders in a specific local share directory for them to be found at all.

One documentation slip is worth noting because it is the kind that wastes a reader's time: the page calls the shell file a directory. It is a file, and the path ends in a filename.

The installer backs up what it replaces and reports what is missing

The installation section is short, and it rests on one shell script at the repository root.

The documented behaviour of that script has exactly two parts, stated twice in the page. It moves the relevant configuration directories into the configuration folder in the user's home directory, and before replacing anything it creates backups of existing directories. A tip near the dependency list adds the second behaviour: it notifies you if anything is missing.

The manual alternative is offered for anyone who would rather not run it, and it is genuinely manual: find the configuration directories in the repository and move them yourself. Nothing is documented about what the script does beyond those two things, so a reader who wants to know what gets written where has to read the script.

The page is clear that installing is not the same as being finished. It lists three things still to do by hand afterwards: set up wallpapers, set up monitors, and choose which of the terminal themes to use. The terminal themes are included, one per colour variant the theme ships.

One more deliberate omission. Interface styling and cursor themes are not in the repository, on the grounds that they are a matter of taste and many styles would work; the recommended helper application is pointed at for setting them instead. A future detailed video guide is mentioned as a possibility.

The last line of the page calls the keybindings the author's personal preferences and invites anyone to change them freely.

One release, an empty screenshot table, and wallpapers in another repository

The repository itself is small enough to describe in one line: a licence, a readme, an install script, and three directories holding configurations, an icon theme and screenshots.

The release history has one entry, version 0.1, published on 2026-06-28 and named as the first version. The last commit to the default branch is dated 2026-07-20, so there have been commits since without a second release, which is consistent with the author's advice to reinstall from the releases page often and with his note that he is busy.

The screenshot presentation on the page is two tables, one labelled for a theme picker and one for weather widgets, and every cell in both is empty. There is a screenshots directory in the repository, so the material plausibly exists and was not inserted. The page acknowledges the rest with three words and an ellipsis.

The wallpapers are in a separate repository under the same account, linked from the page. So a complete installation is three things to fetch: this repository, the wallpapers, and, for anyone who does not already have it, an account with a weather data service.

Three social links sit at the top of the page, a chat invite, a small donation link and a video. The video is consistent with the stated reason for version 0.1, which was to have something finished and ready to record.

Editorial conclusion

This is an art project with a working installer, not a maintained desktop configuration, and the project is the first to say so. Read the warning before anything else: the stated purpose was a proof of concept for a video, a large refactor is planned, interface performance was explicitly not a design concern, there is one release, and the author asks you to reinstall often because that is how you get updates. That framing changes what you should expect and makes the absent settings tab, the empty screenshot table and the hand-edited monitor configuration read as incompleteness rather than as omissions. Two things to check before you install. Count the dependencies as hard requirements rather than suggestions, because a terminal emulator and a file manager are both in the required list with the note that the theme's configuration for each is what the defaults point at, and a socket relay utility is in the list with no stated purpose at all. And plan for the configuration step, because monitor details and wallpaper directories have to be set by editing two files by hand before the theme renders correctly, and a third-party weather service has to be registered for one of the widgets. Who should use it: someone on Hyprland who likes the aesthetic, is willing to edit configuration, and treats the theme as something they will maintain themselves. Who should not: anyone who wants a finished, pinned, settings-driven desktop, or anyone who needs a theme that does not reach a network service for part of its function. What this is not is a distribution. The repository is five files and three directories, the installer is one shell script, and the wallpapers live in a different repository entirely.

Frequently asked questions

What desktop environment does linux-antiquity target?

The Hyprland compositor, above version 0.55, with a Quickshell shell layer above 0.3.0. The version floor on the compositor tracks the change to a Lua configuration format, which is where the theme's own compositor settings live.

Is linux-antiquity safe to install as a daily theme?

The project says otherwise in its own warning notice. It describes itself as an art project whose first version was a proof of concept for a video, tells the reader to install and use it at their own risk, states that a large portion of the code will be refactored after version 0.1, and says the interface is not optimised.

What does installing linux-antiquity do to my existing config?

The install script moves the relevant configuration directories into your configuration folder and, according to the page, creates backups of existing directories before replacing them, and notifies you if dependencies are missing. The page documents no other behaviour, so a reader who wants the full picture has to read the script.

Why does the linux-antiquity weather widget need an account?

It uses a commercial weather data service, and the page says to register for an account and enter the details in the theme's settings menu, opened from the left side bar buttons. The free tier is described as more than enough for the widgets, which still means a third-party rate-limited service is part of the theme's function.

How do I change the icon theme in linux-antiquity?

Edit the top lines of the shell configuration file and set two pragma directives, one for the icon theme and one for the environment variable that carries it. The theme ships its own icon theme, and any replacement folder has to be placed in the local share icons directory to be found.

Does linux-antiquity ship GTK and cursor themes?

No, deliberately. The page says the author decided not to include interface styling and cursor themes because they are a matter of taste and many styles would suit, and points at a helper application for setting them along with the icon theme and other desktop appearance settings.

Official sources

  1. diinki/linux-antiquity on GitHub
  2. Issues
  3. License: MIT
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/diinki-linux-antiquity.svg)](https://hysenlabs.com/projects/diinki-linux-antiquity)