code.delx.au - refind/blob - docs/refind/themes.html

   1 <?xml version="1.0" encoding="utf-8" standalone="no"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   3   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6 <head>
   7   <title>The rEFInd Boot Manager: Theming rEFInd</title>
   8   <link href="../Styles/styles.css" rel="stylesheet" type="text/css" />
   9 </head>
  10
  11 <body>
  12   <h1>The rEFInd Boot Manager:<br />Theming rEFInd</h1>
  13
  14   <p class="subhead">by Roderick W. Smith, <a
  15 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
  16
  17   <p>Originally written: 4/19/2012; last Web page update: 4/22/2012, referencing rEFInd 0.3.0</p>
  18
  19
  20 <p>I'm a technical writer and consultant specializing in Linux technologies. This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!</p>
  21
  22 <table border="1">
  23 <tr>
  24 <td>Donate $1.00</td>
  25 <td>Donate $2.50</td>
  26 <td>Donate $5.00</td>
  27 <td>Donate $10.00</td>
  28 <td>Donate another value</td>
  29 </tr>
  30 <tr>
  31 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
  32 <input type="hidden" name="cmd" value="_xclick">
  33 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
  34 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
  35 <input type="hidden" name="currency_code" value="USD">
  36 <input type="hidden" name="amount" value="1.00">
  37 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
  38 </form>
  39
  40 </td>
  41 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
  42 <input type="hidden" name="cmd" value="_xclick">
  43 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
  44 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
  45 <input type="hidden" name="currency_code" value="USD">
  46 <input type="hidden" name="amount" value="2.50">
  47 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
  48 </form>
  49
  50 </td>
  51 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
  52 <input type="hidden" name="cmd" value="_xclick">
  53 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
  54 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
  55 <input type="hidden" name="currency_code" value="USD">
  56 <input type="hidden" name="amount" value="5.00">
  57 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
  58 </form>
  59
  60 </td>
  61 <td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
  62 <input type="hidden" name="cmd" value="_xclick">
  63 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
  64 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
  65 <input type="hidden" name="currency_code" value="USD">
  66 <input type="hidden" name="amount" value="10.00">
  67 <input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
  68 </form>
  69
  70 </td>
  71 <td>
  72 <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
  73 <input type="hidden" name="cmd" value="_donations">
  74 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
  75 <input type="hidden" name="lc" value="US">
  76 <input type="hidden" name="no_note" value="0">
  77 <input type="hidden" name="currency_code" value="USD">
  78 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
  79 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
  80 <input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
  81 <img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
  82 </form>
  83 </td></tr>
  84 </table>
  85
  86 <hr />
  87
  88 <p>This page is part of the documentation for the rEFInd boot manager. If a Web search has brought you here, you may want to start at the <a href="index.html">main page.</a></p>
  89
  90 <hr />
  91
  92 <h2>Theming Basics</h2>
  93
  94 <p>As described on various other pages of this document, rEFInd relies on icon files located in its <tt>icons</tt> subdirectory, and occasionally elsewhere, to define its overall appearance. You can adjust rEFInd's theme in a few ways:</p>
  95
  96 <ul>
  97
  98 <li>You can create new icons and place them in the <tt>icons</tt> subdirectory. This will affect the appearance of the OS tags, the utility tags, and so on. The names of these icons are fairly self-explanatory. Be aware that rEFInd expects its icons to be in Apple's <a href="http://en.wikipedia.org/wiki/Icns">icon image format (ICNS).</a> You can generate such files easily in various Apple programs, or by using the <a href="http://icns.sourceforge.net/">libicns</a> library (and in particular its <tt>png2icns</tt> program) in Linux.</li>
  99
 100 <li>You can customize the appearance of an individual boot loader by placing an ICNS file in its directory with the same name as the boot loader but with a <tt>.icns</tt> extension. For instance, if your boot loader program is <tt>elilo.efi</tt>, you can create a custom icon by naming it <tt>elilo.icns</tt>.</li>
 101
 102 <li>You can provide an icon for boot loaders stored in the root directory of a filesystem by placing a file called <tt>.VolumeIcon.icns</tt> in that volume's root.</li>
 103
 104 <li>You can set a custom badge (the small icon that identifies the disk type) by creating a file called <tt>.VolumeBadge.icns</tt> in that volume's root. This setting applies to all the boot loaders found on this volume, even if they're in subdirectories.</li>
 105
 106 <li>You can adjust the selection background (used to highlight a selected icon) by creating new icons in Microsoft's <a href="http://en.wikipedia.org/wiki/BMP_file_format">BMP format</a>. You should create both 144x144 and 64x64 images and tell rEFInd about them by using the <tt>selection_big</tt> and <tt>selection_small</tt> tokens, respectively, in <tt>refind.conf</tt>.</li>
 107
 108 <li>You can create a new background image and logo by placing a BMP file in rEFInd's main directory and passing its filename to rEFInd with the <tt>banner</tt> option in <tt>refind.conf</tt>. If the image is smaller than the screen, the color in the top-left corner of the image will be used for the rest of the display.</li>
 109
 110 </ul>
 111
 112 <p>Of course, not all of these elements are likely to be included in themes. A minimal rEFInd theme would include just some changes to the icons in the <tt>icons</tt> subdirectory. A more thorough theme would include a changed background image or selection backgrounds.</p>
 113
 114 <p><b>Note:</b> If you'd like to design a logo for rEFInd, please do so! I lack the sort of artistic talent required for creating logos, so I just used plain text. I'd like to have something more eye-catching, though. I don't promise to use the first logo I'm given, but if you have some ideas, or would like to discuss some ideas, feel free to <a href="mailto:rodsmith@rodsbooks.com">e-mail me.</a></p>
 115
 116 <h2>Known Themes</h2>
 117
 118 <p>I used icons from the Oxygen Icons project, both from the <a href="http://deviantdark.deviantart.com/art/Oxygen-Refit-70199755">Oxygen Refit</a> package and from Gentoo's <tt>oxygen-icons</tt> package. These icons supplemented or replaced icons that rEFIt used; however, many OS icons (such as those for Windows and Mac OS) are carried over from rEFIt. I've also used a handful of icons for individual Linux distributions from other sources&mdash;usually documentation associated with the distribution in question.</p>
 119
 120 <p>In addition to this default icon set, I've received word of one other rEFInd theme:</p>
 121
 122 <ul>
 123
 124 <li><a href="http://ecto-plazm.deviantart.com/art/rEFInd-Icon-Theme-296571397">ecto-plazm's theme</a></li>
 125
 126 </ul>
 127
 128 <p>If you've created or discovered another rEFInd theme, please <a href="mailto:rodsmith@rodsbooks.com">tell me about it</a> so that I can provide a link to it from this page.</p>
 129
 130 <hr />
 131
 132 <p>copyright &copy; 2012 by Roderick W. Smith</p>
 133
 134 <p>This document is licensed under the terms of the <a href="FDL-1.3.txt">GNU Free Documentation License (FDL), version 1.3.</a></p>
 135
 136 <p>If you have problems with or comments about this Web page, please e-mail me at <a href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com.</a> Thanks.</p>
 137
 138 <p><a href="index.html">Go to the main rEFInd page</a></p>
 139
 140 <p><a href="linux.html">Learn about methods of booting Linux with rEFInd</a></p>
 141
 142   <p><a href="http://www.rodsbooks.com/">Return</a> to my main Web page.</p>
 143 </body>
 144 </html>