daedreth / urxvtconfig

A graphical user interface tool for configuration of the rxvt-unicode terminal emulator.

URXVTConfig

A graphical user interface tool for configuration of the rxvt-unicode terminal emulator.

How-to

• File

  • New: Resets all configuration options to the default values.
  • Load from custom file: Loads a specifiable configuration file.
  • Load from Xdefaults: Same as above, loads ~/.Xdefaults.
  • Load from Xresources: Same as above, loads ~/.Xresources.
  • Save to custom file: Saves currently selected options to a custom file.
  • Save to Xdefaults: Same as above, saves to ~/.Xdefaults.
  • Save to Xresources: Same as above, saves to ~/.Xresources.
  • Colors from file: Generates a color scheme using an image, refer to "Colors from file" further down below.
  • Quit: Rather selfexplanatory.

• Presets

  • Select one of premade and shamelessly borrowed color schemes!

• User Presets

  • Choose Preset: Select one from your saved themes, refer to "Custom Themes" further down below.
  • Save Preset: Saves currently selected colors to the preset database.

• Help

  • Help: Sends you to view this file.
  • About: Displays a tiny window with general information.

Dependencies

qt5 - For the GUI.

imagemagick - For generating color schemes from files.

fontconfig and libXft - For font selection.

It also requires rxvt-unicode to be built with "xft" support. If you do not know what this means, don't worry about it.

How do I get it

• Arch

We're on the AUR now, use your favorite AUR helper.

https://aur.archlinux.org/packages/urxvtconfig

This will build from the latest commit on the "master" branch.

• Gentoo

urxvtconfig is part of the main portage tree.

https://packages.gentoo.org/packages/x11-misc/urxvtconfig

Sync your portage and emerge --ask --verbose x11-misc/urxvtconfig

• Void

urxvtconfig is part of the main repository.

xbps-install -S urxvtconfig

• Other distributions

As time passes, I will try to get this into as many repositories as I can, for now, just grab the latest release.

I highly recommend to build it yourself as described just below:

Build it yourself

Requires qt5 (qmake) and is highly encouraged.

$ git clone https://github.com/daedreth/URXVTConfig.git
$ cd URXVTConfig
$ qmake -qt=qt5 source/URXVTConfig.pro
$ make
$ sudo make install

If qmake does not appear to be working, you have to specify the full path to the qmake executable.

/usr/lib64/qt5/bin/qmake source/URXVTConfig.pro

Colors from file

If you have imagemagick installed, you can attempt to generate a nicely looking theme from an image.

The way this works is, we extract enough colors without duplicates and apply, you are obviously free to modify them once generated.

Custom themes

You can easily save and load custom themes.

Create the following file to get started: ~/.config/urxvtconfig/presets.db.

You can save your selected colors under a specific name to use at a later time, or load from the file.

It 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: (make sure each one is on a new line)

Theme Name: <foreground>,<background>,<cursorColor>,<16 other colors>

Where the colors are HTML color codes, separated by commas. (HEX) Save a configuration and manually edit the file to see exactly how that works.

The name may contain spaces and special characters, the only character it can not contain is a colon :.

Configuration

You can modify the way URXVTConfig works by creating and editing a configuration file.

By default, the file it is looking for upon launch is ~/.config/urxvtconfig/config.

The syntax and possible options so far are:

no_warnings: true | false - If set to true, we will stop nagging about installing third party plugins and a few other annoying warnings.

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.

As this project grows, I will be adding more configuration options if necessary.

Troubleshooting

• I saved the changes, encountered no error message and URXVT still didn't change, what do?

  • Make sure your "USER" environmental variable has not been altered.

• I keep running into an error message about "not having permissions" to write to the file.

  • Run chown -R <username>:<usergroup> /home/<username> as root to fix that.
  • This will restore permissions to your "home" directory.

• My old configuration is not read properly!

  • 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.

• Why is my transparency not working?

  • Your composite manager may be disabled. Try fake transparency.

• I enabled certain plugins and they do nothing!

  • Install them via your distributions package manager (ex.g urxvt-perls).

Contribution guidelines

This is a rather basic project, pull requests are welcome. Issues will be resolved as fast as possible.

The code is to remain as simple to modify and as readable as only possible.

License

This file is part of URXVTConfig.

URXVTConfig is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

URXVTConfig is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with URXVTConfig.  If not, see <http://www.gnu.org/licenses/>.

Credits

• The QTeam, for a framework that isn't horrible.
• Jesskas, for motivation.
• Seriel, for creating the PKGBUILD.

urxvtconfig's Issues

True transparency support

Would it be possible to enable true transparency support by default?

Example:
URxvtbackground: [85]#232c31
URxvtdepth: 32

This is with the codeschool colour theme background.

Saves to /home/user Rather Than $HOME/

Running with a user home set to /user/ rather than /home/user/ still saves both the app's config and .Xresources etc to /home/ which is useless

Package for Void linux

Hi @daedreth !

I created a package for Void linux, see #9645.

Regards.

xrdb: colon missing on line 7, ignoring line

When the file is generated, the "*.cursorColor:" colon is missing.

Dropping last character in font name

When you change the font, it drops the last character of the font name, causing it not to load properly. I've noticed it with all the fonts I've tried.

URxvt.font: xft:Anonymous Pr:pixelsize=12

arch aur upgrade problem

I have installed your package from aur and it is working perfectly.The only problem is that every time i run
yaourt -Syu --aur to update every package , urxvtconfig pops up with this
aur/urxvtconfig 1.0.r6.g3ef7024-1 -> 1.5.47d7f67-1 . That is happening for 3 days straight and i don't know if it is a problem of my laptop or something that you have misconfigured.
Keep up the good work!

32bit compatible

So, yeah, I tried to build it and I'm running on a 32bit machine. Apparently you had it set it up only for 64bit on the qt4 libs. Is it possible to make it 32bit compatible?

Text fields not increasing to meet text length and window cannot be resized.

Me again!

I am experiencing this visual issue with the transparency text as well as the current font text, seen in the image below:

The color scheme numbers don't seem to line up currently, the black value starts on "#4". Also maybe putting the color names would be better for anyone new to customizing URXVT.

I am also unable to resize the window so that the text is inside the fields. I put these issues together as I believe that one would help resolve another.