{"id":13441298,"url":"https://github.com/daedreth/URXVTConfig","last_synced_at":"2025-03-20T11:38:11.969Z","repository":{"id":55279386,"uuid":"79750094","full_name":"daedreth/URXVTConfig","owner":"daedreth","description":"A graphical user interface tool for configuration of the rxvt-unicode terminal emulator.","archived":false,"fork":false,"pushed_at":"2017-11-30T11:41:11.000Z","size":63,"stargazers_count":167,"open_issues_count":1,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-01T03:33:58.595Z","etag":null,"topics":["color-scheme","imagemagick","urxvt","xdefaults","xresources"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daedreth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-22T22:24:19.000Z","updated_at":"2024-05-29T06:43:13.000Z","dependencies_parsed_at":"2022-08-14T19:11:11.301Z","dependency_job_id":null,"html_url":"https://github.com/daedreth/URXVTConfig","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daedreth%2FURXVTConfig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daedreth%2FURXVTConfig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daedreth%2FURXVTConfig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daedreth%2FURXVTConfig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daedreth","download_url":"https://codeload.github.com/daedreth/URXVTConfig/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221759950,"owners_count":16876323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["color-scheme","imagemagick","urxvt","xdefaults","xresources"],"created_at":"2024-07-31T03:01:32.195Z","updated_at":"2024-10-28T01:30:28.530Z","avatar_url":"https://github.com/daedreth.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"# URXVTConfig\nA graphical user interface tool for configuration of the rxvt-unicode terminal emulator.\n\n\n![urxvtconfig screenshot](http://i.imgur.com/vCnijHx.png)\n\n\n# How-to\n- File\n\t- New: Resets all configuration options to the default values.\n\t- Load from custom file: Loads a specifiable configuration file.\n\t- Load from Xdefaults: Same as above, loads `~/.Xdefaults`.\n\t- Load from Xresources: Same as above, loads `~/.Xresources`.\n\t- Save to custom file: Saves currently selected options to a custom file.\n\t- Save to Xdefaults: Same as above, saves to `~/.Xdefaults`.\n\t- Save to Xresources: Same as above, saves to `~/.Xresources`.\n\t- Colors from file: Generates a color scheme using an image, refer to \"Colors from file\" further down below.\n\t- Quit: Rather selfexplanatory.\n\n- Presets\n\t- Select one of premade and shamelessly borrowed color schemes!\n\n- User Presets\n\t- Choose Preset: Select one from your saved themes, refer to \"Custom Themes\" further down below.\n\t- Save Preset: Saves currently selected colors to the preset database.\n\n- Help\n\t- Help: Sends you to view this file.\n\t- About: Displays a tiny window with general information.\n\n\n# Dependencies\n`qt5` - For the GUI.\n\n`imagemagick` - For generating color schemes from files.\n\n`fontconfig` and `libXft` - For font selection.\n\nIt also requires rxvt-unicode to be built with \"xft\" support.\nIf you do not know what this means, don't worry about it.\n\n\n# How do I get it\n\n- Arch\n\nWe're on the AUR now, use your favorite AUR helper.\n\n**https://aur.archlinux.org/packages/urxvtconfig**\n\nThis will build from the latest commit on the \"master\" branch.\n\n- Gentoo\n\n`urxvtconfig` is part of the main portage tree.\n\n**https://packages.gentoo.org/packages/x11-misc/urxvtconfig**\n\nSync your portage and `emerge --ask --verbose x11-misc/urxvtconfig`\n\n- Void\n\n`urxvtconfig` is part of the main repository.\n\n`xbps-install -S urxvtconfig`\n\n- Other distributions\n\nAs time passes, I will try to get this into as many repositories as I can, for now, just grab the latest release.\n\nI highly recommend to build it yourself as described just below:\n\n\n# Build it yourself\nRequires qt5 (qmake) and is highly encouraged.\n\n  ~~~ sh\n  $ git clone https://github.com/daedreth/URXVTConfig.git\n  $ cd URXVTConfig\n  $ qmake -qt=qt5 source/URXVTConfig.pro\n  $ make\n  $ sudo make install\n  ~~~\n\nIf qmake does **not** appear to be working, you have to specify the full path to the qmake executable.\n\n`/usr/lib64/qt5/bin/qmake source/URXVTConfig.pro`\n\n\n# Colors from file\n\nIf you have `imagemagick` installed, you can attempt to generate a nicely looking theme from an image.\n\nThe way this works is, we extract enough colors without duplicates and apply, you are obviously free to modify them once generated.\n\n\n# Custom themes\n\nYou can easily save and load custom themes.\n\nCreate the following file to get started: `~/.config/urxvtconfig/presets.db`.\n\nYou can save your selected colors under a specific name to use at a later time, or load from the file.\n\nIt goes without saying that it's possible to manually edit the file in order to add or remove presets, the syntax for a preset is as follows:\n(make sure each one is on a new line)\n\n`Theme Name: \u003cforeground\u003e,\u003cbackground\u003e,\u003ccursorColor\u003e,\u003c16 other colors\u003e`\n\nWhere the colors are HTML color codes, separated by commas. (HEX)\nSave a configuration and manually edit the file to see exactly how that works.\n\nThe name may contain spaces and special characters, the only character it can not contain is a colon `:`.\n\n\n# Configuration\n\nYou can modify the way URXVTConfig works by creating and editing a configuration file.\n\nBy default, the file it is looking for upon launch is `~/.config/urxvtconfig/config`.\n\nThe syntax and possible options so far are:\n\n`no_warnings: true | false` - If set to true, we will stop nagging about installing third party plugins and a few other annoying warnings.\n\n`no_backups: true | false` - If set to true, we will stop asking if you'd like to create a backup each time you save your configuration.\n\nAs this project grows, I will be adding more configuration options if necessary.\n\n\n# Troubleshooting\n- I saved the changes, encountered no error message and URXVT still didn't change, what do?\n\t- Make sure your \"USER\" environmental variable has not been altered.\n\n- I keep running into an error message about \"not having permissions\" to write to the file.\n\t- Run `chown -R \u003cusername\u003e:\u003cusergroup\u003e /home/\u003cusername\u003e` as root to fix that.\n\t- This will restore permissions to your \"home\" directory.\n\n- My old configuration is not read properly!\n\t- Reset to default values and save to ensure functionality. This tool has a very low tolerance for syntax that doesn't conform to it's settings.\n\n- Why is my transparency not working?\n\t- Your composite manager may be disabled. Try fake transparency.\n\n- I enabled certain plugins and they do nothing!\n\t- Install them via your distributions package manager (ex.g urxvt-perls).\n\n# Contribution guidelines\n\nThis is a rather basic project, pull requests are welcome.\nIssues will be resolved as fast as possible.\n\nThe code is to remain as simple to modify and as readable as only possible.\n\n# License\n\n    This file is part of URXVTConfig.\n\n    URXVTConfig is free software: you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n\n    URXVTConfig is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with URXVTConfig.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n\n# Credits\n- The QTeam, for a framework that isn't horrible.\n- Jesskas, for motivation.\n- Seriel, for creating the PKGBUILD.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaedreth%2FURXVTConfig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaedreth%2FURXVTConfig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaedreth%2FURXVTConfig/lists"}