Guide to Creating Skins
How to use Skins
This guide is for creating skins. For details on using skins, visit the guide to using skins.
Packaging your skin
In µTorrent 2.2, we tried to simplify skinning the client, so there is now a new format called .btskin. This is a zip file consisting of all the supported skin filetypes, named with the extension .btskin instead of .zip. Loading the skin is as easy as double clicking, or drag and dropping onto µTorrent.
We've also added the ability to customize the colors in µTorrent. It is a text file named 'btskin' included in the skin package. Details on creating it are further down on the page.
Folder locations for manual installs
The currently loaded skin is saved by µTorrent as current.btskin. It is placed in %AppData%\uTorrent. %AppData% is a shortcut for the user's application data folder. To use this path, type it into the address bar and press Enter.
Creating the individual skin files
The following types of skin files are supported
-
tray.ico
This is a standard Windows icon file. It will replace the default icon in the system tray (bottom-right corner of your screen).
-
main.ico
This icon replaces the default icon at the top-left of the µTorrent window.
-
maindoc.ico
This is used for the icon on .torrent associations. To apply the change, open the Preferences and hit "Associate with .torrent files"
-
toolbar.bmp
A 304x24 Windows bitmap. If it's found, it replaces the toolbar running across the top of the main µT window. It's made up of 13 24x24 bitmaps placed right next to each other (with no whitespace in between) in the same order as they appear in the toolbar. If the dimensions are incorrect, µTorrent will still attempt to create the toolbar, but some graphic problems might occur (for example, the text in the search box not being totally readable).
-
tstatus.bmp
Short for 'torrent status', this is a 256x16 bitmap with similar parameters to toolbar.bmp, except individual icons are only 16x16 pixels.
-
tabs.bmp
A 224x16 bitmap with similar parameters to toolbar.bmp, except individual icons are only 16x16 pixels. The icons are for the tabs in the "Detailed Info" bar. Half are the icons when active, the other half are greyed out versions when they're inactive.
Customizing µTorrent's colors
The new btskin format allows you to customize the colors in µTorrent. Almost all the colors can be modified, though many are only supported in 3.0. To customize it, create a text file named 'btskin' and package it into your skin. Invalid colors or settings will be ignored. Comments must be on their own newline.
The following is a list of supported colors and their defaults in 2.2 (or 3.0 if a 3.0-only setting).
download_progress:99cc33 seed_progress:3b9bfc paused_progress:cccccc stopped_progress:86c440 downerr_progress:ff3333 seederr_progress:ff3333 error_progress:ff3333 finished_progress:86c440 queued_progress:89c248 queued_incomplete_progress:3399ff progress_bar_bg:dddddd download_progress_text:666666 seed_progress_text:666666 paused_progress_text:666666 stopped_progress_text:666666 downerr_progress_text:666666 seederr_progress_text:666666 error_progress_text:666666 finished_progress_text:666666 queued_progress_text:666666 queued_incomplete_progress_text:666666 upload_rate_limit:800000 download_rate_limit:008000 upload_rate_payload:ff0000 download_rate_payload:00ff00 upload_rate_local:ff7070 download_rate_local:70ff70 upload_rate_overhead:800000 download_rate_overhead:008000 tcp_upload_limit:803080 tcp_download_limit:308080 tcp_upload_rate:803080 tcp_download_rate:308080 player_send_rate:d0d000 ack_upload:ff0000 ack_download:00ff00 header_upload:ff7070 header_download:70ff70 connect_upload:ff8888 connect_download:88ff88 close_upload:ff6000 close_download:60ff00 retransmission_upload:600000 retransmission_download:006000 cache_reading:800000 file_reading:ff0000 cache_writing:008000 file_writing:00ff00 eye_piece:ffffff cursor_piece:0000ff deadline_piece:00ff00 hole_piece:00ffff ghost_piece:ff0000 prio_window_start:ff00ff prio_window_end:ffff00 total_pieces:7f7f7f critical requests:00007f critical requests cancelled:007f00 non-critical requests:007f7f buffer_size:7f0000 secs_ahead_of_ghost:7f007f secs_ahead_of_eye:7f7f00 secs_of_underrun:0f0f0f peak_send_delay:800000 avg_send_delay:ff0000 min_send_delay:800000 peak_recv_delay:008000 avg_recv_delay:00ff00 min_recv_delay:008000 target_delay:aaaaaa graph_bg:000040 graph_border:c0c0ff graph_text:ffffff graph_ruler:20209f graph_legend_bg:000020 graph_legend_text:e0e0ff pieces_have:5050ff pieces_dont_have:f0f0ff pieces_unavailable:ff0000 pieces_requested:60ff60 stream_progress:3acc33 search_border:99cc33 piece_idle:ffffff piece_written:0000ff piece_writing:6060ff piece_multi_request:c0ffc0 piece_streaming:00b0b0 piece_cancelled:ffff00 piece_requested:c0c0ff sched_full_speed:00a800 sched_limited:8dce8d sched_turn_off:ffffff sched_seed_only:ffc0c0 list_background:ff00ff list_alternate_background:f0f0f0 list_text:ff00ff sidebar_background:ff00ff sidebar_text:ff00ff sidebar_sep_line_gradient_start:bfbfbf sidebar_sep_line_gradient_end:bfbfbf sidebar_sep_shadow_gradient_start:f9f9f9 sidebar_sep_shadow_gradient_end:ffffff drop_zone_background:ff00ff drop_zone_text:ff00ff menu_background:ff00ff toolbar_background:ff00ff find_pane_background:ffffff find_pane_search_btn_background:ffffff find_pane_text:000000 find_pane_subtext:787878 download_list_highlight:787878 healthbar:00853f healthbar_bg:cccbcb
