rofi/releasenotes/1.7.0/release-1.7.0.markdown

# 1.7.0: Iggy 2024

![Iggy](./iggy.jpg)

Rofi 1.7.0 is another bug-fix release that also removes a lot of deprecated features.   One of the biggest changes is
the removal of the (deprecated) xresources based configuration setup. With this removal, also a lot of hack-ish code has
been removed that tried to patch old config setups.  While the deprecation might be frustrating for people who have not
yet converted to the new format, I hope for some understanding. Even though this move might not be popular, the
deprecation in previous releases and consequential removal of these options is needed for two reasons.
The most important one is to keep rofi maintainable and secondary to open possibility to overhaul the config system in
the future and with that fixing some long standing bugs and add new options that
where hindered by the almost 10 year old system.

Beside mostly bug-fixes and removal of deprecated options, we also improved the theming and added features to help in
some of the more 'off-script' use of rofi.

This release was made possible by many contributors, see below for a full list. Big thanks again to SardemF77 and
TonCherAmi.

## File Browser

TonCherAmi made several very nice usability improvements to the file-browser. His changes allow you to define sorting
and ordering of the entries and changing the default start directory.

These options can be set using the new 'nested' configuration format that we are testing in rofi:

```css
configuration {
   filebrowser {
      /** Directory the file browser starts in. */
      directory: "/some/directory";
      /**
        * Sorting method. Can be set to:
        *   - "name"
        *   - "mtime" (modification time)
        *   - "atime" (access time)
        *   - "ctime" (change time)
        */
      sorting-method: "name";
      /** Group directories before files. */
      directories-first: true;
   }
}
```


## File Completion

In run and drun you can add a file argument to the executable by pressing
`Control-l` (In drun this only works, if the desktop file indicates that the
application supports this.)


![completer](./complete.gif)

This is not the final implementation, I plan to extend this and make this more configurable.


## Timeout actions

You can now configure an action to be taken when rofi has not been interacted with for a certain amount of seconds.
You can specify a keybinding to trigger after X seconds.

This option can be set using the new 'nested' configuration format that we are testing in rofi:

```css
configuration {
  timeout {
      delay:  15;
      action: "kb-cancel";
  }
}
```

This setting will close rofi after 15 seconds of no interaction.

## Background image and gradients

```css
window {
    background-image: url("/tmp/i3.png", both);
}
element {
    children: [element-icon, element-text];
    background-image: linear-gradient(to bottom, black/20%, white/20%, black/10%);
}
```

The below screenshot shows both background image and gradients.

![background image](./background-image.png)


## Clickable button and icons

```css
icon-paste {
    expand: false;
    filename: "gtk-paste";
    size: 24;
    vertical-align: 0.5;
    action: "kb-primary-paste";
}
```

```css
button-paste {
    expand: false;
    content: "My Clickable Message";
    vertical-align: 0.5;
    action: "kb-primary-paste";
}
```

The screenshot below shows a non-squared image and clickable buttons (the close icon in the top right) 

![rofi icons](./rofi-icons.png)

# Changelog

* ADD: -steal-focus option.
* ADD: [Config] Add nested configuration option support.
* ADD: [Config] Support for handling dynamic config files.
* ADD: [DRun] Add fallback icon option.
* ADD: [DRun] Add support for passing file (using file-browser) completer for desktop files that support his.
* ADD: [DRun] Support for service files.
* ADD: [File Browser] Allow setting startup directory (#1325)
* ADD: [File Browser]: Add sorting-method. (#1340)
* ADD: [FileBrowser] Add option to group directories ahead of files. (#1352)
* ADD: [Filtering] Add prefix matching method. (#1237)
* ADD: [Icon] Add option to square the widget.
* ADD: [Icon|Button] Make action available on icon, button and keybinding name.
* ADD: [KeyBinding] Add Ctrl-Shift-Enter option. (#874)
* ADD: [ListView]-hover-select option. (#1234)
* ADD: [Run] Add support for passing file (using file-browser) completer.
* ADD: [Textbox] Allow theme to force markup on text widget.
* ADD: [Theme] Remove backwards compatiblity hack.
* ADD: [Theme] theme validation option. (`-rasi-validate`)
* ADD: [View] Add support for user timeout and keybinding action.
* ADD: [Widget] Add cursor property (#1313)
* ADD: [Widget] Add scaling option to background-image.
* ADD: [Widget] Add support background-image and lineair gradient option.
* ADD: [Window] Add pango markup for window format (#1288)
* FIX: [DSL] Move theme reset into grammar parser from lexer.
* FIX: [Drun]: fix sorting on broken desktop files. (thanks to nick87720z)
* FIX: [File Browser]: Fix escaping of paths.
* FIX: [ListView] Fix wrong subwidget name.
* FIX: [Script] Don't enable custom keybindings by default.
* FIX: [TextBox] Fix height estimation.
* FIX: [Theme] widget state and inherited properties. This should help fixing some old themes with changes from 1.6.1.
* FIX: [Widget] Fix rendering of border and dashes. (Thanks to nick87720z)
* REMOVE: -dump-xresources
* REMOVE: -fullscreen
* REMOVE: -show-match
* REMOVE: Old xresources based configuration file.
* REMOVE: fake transparency/background option, part of theme now.
* REMOVE: xresources parsing via Xserver
* DOC: Update changes to manpages


# Thanks

Big thanks to:

* Quentin Glidic
* a1346054
* Ian C
* TonCherAmi
* nick87720z
* Markus Grab
* Zachary Freed
* nickofolas
* unisgn
* Jas
* rahulaggarwal965
* Awal Garg
* Eduard Lucena
* Lars Wendler

Apologies if I mistyped or missed anybody.