Skip to content

Latest commit

 

History

History
88 lines (56 loc) · 2 KB

README.md

File metadata and controls

88 lines (56 loc) · 2 KB

xseticon-pmb

Change the window icon of an already-running X11 application. A stripped-down fork of Paul Evans' xseticon.

This project is based on Paul Evans' very useful xseticon. More specifically, on commit 8e3da2 .

Comparison with upstream

The major changes I introduced:

  • Removed all the code marked as FROM programs/xlsfonts/dsimple.c because I'm not 100% sure the licenses are compatible. (Issue #12)
  • Omit window ID detection code. That part is suffficiently solved by xdotool.
    • This also saves me from any doubt about whether these parts of the code are tainted by potential xlsfonts license issues.
    • Omitting the mouse aiming code allows to drop the dependency on libxmu-dev.

Usage

Usage: xseticon-pmb [--verbose] <windowid> <iconfmt> <iconfile>

<windowid>: xterm provides it as $WINDOWID.
    For other applications, xdotool can find it for you.
    Decimal (just an integer) or '0x' + hexadecimal.

<iconfmt>: Image format.
    Currently understands 'png', 'svg' and 'GUESS',
    the latter meaning to naively guess from <iconfile>.
    (However, SVG support isn't implemented yet.)

<iconfile>: Path to an image file.

Building

  1. Recommended build platform is Ubuntu trusty or later.
  2. Clone the repo.
  3. In a shell, run ./src/rebuild.sh
  4. If you get error messages about missing libraries (you need these, install them and retry.
  5. On success, the script should display where your new binary is.

Known issues

  • Needs more/better tests and docs.

 

License

GPL-2.0-or-later