Create your own mouse cursor theme: Difference between revisions
Laubblaeser (talk | contribs) m (→How-To) |
(updated path for finished theme, and included hint to find cursor names in header file) |
||
| Line 7: | Line 7: | ||
* Repeat steps 1-4 for all the different cursors you want to create. | * Repeat steps 1-4 for all the different cursors you want to create. | ||
* Copy the newly created set of X11 cursors to a fresh subdirectory <code>cursors/</code> inside a directory that you name after your new cursor theme <code>$(themename)/</code> (e.g. <code>KoolKursors/cursors/</code>). | * Copy the newly created set of X11 cursors to a fresh subdirectory <code>cursors/</code> inside a directory that you name after your new cursor theme <code>$(themename)/</code> (e.g. <code>KoolKursors/cursors/</code>). | ||
* Create [https://en.wikipedia.org/wiki/Symbolic_link#POSIX_and_Unix-like_operating_systems symlinks] for all the aliases of the cursors <code>ln -s $(filename).png $(alias).png</code> (e.g. <code>ln -s default.png left_ptr.png</code>).<ref>This task can/should be scripted, provided that you have a complete list of regular cursor names and their irregular aliases. Note that this step might cause some frustration regarding incomplete lists of cursor name aliases.</ref> | * Create [https://en.wikipedia.org/wiki/Symbolic_link#POSIX_and_Unix-like_operating_systems symlinks] for all the aliases of the cursors <code>ln -s $(filename).png $(alias).png</code> (e.g. <code>ln -s default.png left_ptr.png</code>). <ref>This task can/should be scripted, provided that you have a complete list of regular cursor names and their irregular aliases. Note that this step might cause some frustration regarding incomplete lists of cursor name aliases.</ref> See <code>/usr/include/X11/cursorfont.h</code> for a list of cursors. | ||
* Create a <code>index.theme</code> file in <code>themename/</code> (Note: not in <code>cursors/</code> but in its parent directory) and fill it with the necessary information like theme name, | * Create a <code>index.theme</code> file in <code>themename/</code> (Note: not in <code>cursors/</code> but in its parent directory) and fill it with the necessary information like theme name, description and possibly a fallback cursor theme.<ref>If you want to add translations for multiple languages, you can do so by using language tags like <code>[en]</code>, <code>[de]</code>, <code>[fr]</code>, etc. for each language (e.g. <code>Comment[en]=My very own cursor theme</code>). Put each of them in a separate line within the <code>index.theme</code> file.</ref> An exemplary <code>index.theme</code> file might look like this: | ||
<pre>[Icon Theme] | <pre>[Icon Theme] | ||
| Line 14: | Line 14: | ||
Comment=My very own cursor theme | Comment=My very own cursor theme | ||
Inherits=breeze_cursors</pre> | Inherits=breeze_cursors</pre> | ||
* Place the whole <code>themename/</code> folder and its freshly created content in <code>~/. | * Place the whole <code>themename/</code> folder and its freshly created content in <code>~/.icons</code>. | ||
* Select your new cursor theme in the system settings of your OS. | * Select your new cursor theme in the system settings of your OS. | ||
Revision as of 14:12, 29 April 2021
How-To
- Create a PNG file of the cursor you want. Preferrably at least in size 32x32 but you can also create multiple resolutions and bundle those into one cursor file. Save this as
$(filename).png(e.g.default.pngfor a regular cursor). - Determine the pixel where the hotspot should sit. The hotspot of a cursor is the point where “the click occurs”. (If you have multiple resolutions for your new cursor, you have to do this step for each of them). It’s necessary to use graphic editing software capable of determining the exact pixel for the hotspot. KDE’s own Krita is well suited for this task but of course other software works just as well.
- Create a
$(filename).cursorfile with the following content:$(resolution) $(hotspot-x) $(hotspot-y) $(filename)in one line (e.g.32 10 5 default.png). - Open a terminal in the working directory and run
xcursorgen $(filename).cursor $(filename)(e.g.xcursorgen default.cursor default).[1] - Repeat steps 1-4 for all the different cursors you want to create.
- Copy the newly created set of X11 cursors to a fresh subdirectory
cursors/inside a directory that you name after your new cursor theme$(themename)/(e.g.KoolKursors/cursors/). - Create symlinks for all the aliases of the cursors
ln -s $(filename).png $(alias).png(e.g.ln -s default.png left_ptr.png). [2] See/usr/include/X11/cursorfont.hfor a list of cursors. - Create a
index.themefile inthemename/(Note: not incursors/but in its parent directory) and fill it with the necessary information like theme name, description and possibly a fallback cursor theme.[3] An exemplaryindex.themefile might look like this:
[Icon Theme] Name=KoolKursors Comment=My very own cursor theme Inherits=breeze_cursors
- Place the whole
themename/folder and its freshly created content in~/.icons. - Select your new cursor theme in the system settings of your OS.
Done. Enjoy your new KoolKursors theme.
- ↑ If you want to create animated cursors (like
wait) the procedure is a bit different. You need one PNG for each animation frame ($(filename)_#.png). Then add all of these as a list to the$(filename).cursorfile with the following content:$(resolution) $(hotspot-x) $(hotspot-y) $(filename) $(animationtime)(e.g.32 16 16 wait_1.png 50 16 16 wait_2.png 50each of them in a separate line). - ↑ This task can/should be scripted, provided that you have a complete list of regular cursor names and their irregular aliases. Note that this step might cause some frustration regarding incomplete lists of cursor name aliases.
- ↑ If you want to add translations for multiple languages, you can do so by using language tags like
[en],[de],[fr], etc. for each language (e.g.Comment[en]=My very own cursor theme). Put each of them in a separate line within theindex.themefile.