documentation

wiki/help/installation_custom_res.txt

@@ -0,0 +1,25 @@
+There are two options for providing your own resources for the patcher to use. You may supply pre-modified or alternative versions of the files themselves (I use this functionality to put pre-reshacked versions of Notepad2 in place of the normal notepad.exe on my own machine.), or supply alternate graphics and resource scripts. 
+
+To use either function, create a folder on your desktop named "override" and follow the instruction in the following section.
+
+### Direct File
+> Note: Your pre-modified files will be ignored if they are not something the WinTango Patcher would normally modify. Either replace it manually, or submit a modification request for that file. During a reload, it will not check files that the original install did not modify.
+
+1. Place your prepared file directly in the override folder (e.g. notepad.exe: `"%userprofile%\Desktop\Override\notepad.exe"`). 
+
+> Important Note for 64-Bit users:
+> Place (e.g. notepad.exe) the 32-Bit file in `"%userprofile%\Desktop\Override\x64\notepad.exe"` and the 64-Bit file in `"%userprofile%\Desktop\Override\notepad.exe"`! 
+
+2. If you're already using the patcher, run the reloader, otherwise, run the installer. 
+
+If you want to go back to the Windows original: 
+* Uninstall the pack to restore the originally backed-up version
+* Copy the version in the patcher's Backup folder to the patcher's Override folder. Run the reloader and reboot, then delete it from the Override subfolder of the Patcher's folder. The reloader will then recognize the file as a new version, reapply the Tango theme, and all will be back to normal. 
+
+### Resources
+> Note: New scripts will be ignored if they are not something the WinTango Patcher already modifies. Either replace the file manually, or submit a modification request for that file.
+
+1. Place your substitute files in the override folder, arranged in an analagous structure to their locations in the Patcher's Resources folder. For example, to provide a custom file to reside in "C:\Program Files\WinTango Patcher \Resources\icons\devices\computer.ico", place it in `"%userprofile%\Desktop\Override\icons\devices\"`.
+2. Run the installer. The reloader does not support resource overloading - it cannot keep track of which resources need to be inserted into which files. 
+
+The files will be moved into the Patcher's resource folder after the installer has copied the selected theme. You will need to re-provide them every time you run the installer. 

wiki/help/installation_guide.txt

@@ -0,0 +1,37 @@
+# Installation Guide
+
+Follow this step by step instruction on how to install the WinTango Patcher and learn all about the Options during Installation.
+
+### Main Screen
+1. Pick the main icon package the Patcher will draw its resources from. 
+1. This is a preview of some sample icons for the selected icon theme.
+1. Click this button to start patching. For the average user this is usually all it takes to start modifying your system.
+1. Still, some of you might want to take a look at some of the available options before hitting "Patch"!
+
+### Options
+In gneral the switches turn the specific option ON / OFF.
+
+1. Choose between patching the tray icons with symbolic (white) or the normal (colorfull) icons. Switch the option off to not patch the tray icons.
+1. Enables/Disables patching of the Start Orb.
+1. Replace the included Windows Notepad with Notepad2, which has way more features like Code Folding or various other Text Operations to make life easier. **Please Note: only the English, German and Chinese versions are currently included!**
+1. Install Sysinternals Desktops to add support for multiple Desktops to Windows 7. This is similar to what Linux supports natively.
+1. Checks for the latest version of the Patcher at system startup to provide you with the latest modifications.
+1. Set the Reloader to run automatically every time you log in, performing a quick check for modified system files and re-replacing them if they have been updated since the Patcher last touched them.
+1. Chosse between some Visual Styles (Shiki-Colors, elementary, Ubuntu) which match the included icon themes. By default the Visual Style which matches the chosen Icon Theme as closely as possible is selected.
+1. Installs the Cursor-Theme known from early Ubuntu. It includes a white and a dark version.
+1. Copies matching Wallpapers for the included Visual Styles: Shiki-Colors, elementary and Ubuntu.
+
+### Advanced Options
+1. This section enables you to either patch those files and risk that some functions of windows might not work anymore or don't patch them and life on the save side.
+1. When selecting to install a Visual Style on the Options Page you can choose which UXTheme Patcher method you prefer. When the Patcher recognizes that your system is already patched this option won't be available (like in this screenshot). **Important: If you are using VirtualBox you need to use the Service Method. Otherwise your VirtualMachines won't start anymore!**
+1. When using custom paths for installing your applications you have to edit those paths for the patcher. Otherwise your applications won't be patched!
+1. This section enables you to select/deselect any Theme you want or don't want to apply. **Note: If the Patcher doesn't find a selected Application on your system, no files will be copied! Keeping this option active won't clutter your OS.**
+
+This description also applies on the following sections:
+* 3rd Party Applications: Files
+* Windows: System Files
+
+### About Page
+This Page provides some basic information on the WinTango Patcher.
+
+By clicking on the respective link you can either contact me or open the latest Changelog as well as the Release Notes.

wiki/help/installation_silent.txt

@@ -0,0 +1,14 @@
+The following commandline switches allow for silent, unattended installation, and allow the patcher to be used as part of an unattended installation script. 
+
+    /S  -  The universal "silent operation" switch. 
+    /theme=gnome  -  Sets the selected theme to Gnome. 
+    /theme=gnome-brave  -  Sets the selected theme to Gnome-Brave. 
+    /theme=gnome-human  -  Sets the selected theme to Gnome-Human. 
+    /theme=gnome-noble  -  Sets the selected theme to Gnome-Noble. 
+    /theme=gnome-wine  -  Sets the selected theme to Gnome-Wine. 
+    /theme=gnome-wise  -  Sets the selected theme to Gnome-Wise. 
+    /theme=cheser  -  Sets the selected theme to Cheser. 
+    /theme=tango  -  Sets the selected theme to Tango. 
+    /theme=tangerine  -  Sets the selected theme to Tangerine. 
+    /theme=elementary  -  Sets the selected theme to Elementary. 
+    /theme=humanity  -  Sets the selected theme to Humanity.

wiki/help/options_cpl.txt

@@ -0,0 +1,28 @@
+# Control Panel App
+
+### Actions Tab
+
+Generally the switches turn the specific option ON / OFF
+
+1. The included reloader module will re-modify your files if they are overwritten, allowing system updates to be performed without breaking the theme. You can either run it manually by clicking on "Reload" or enable the Option to run it on system startup.
+2. Re-Installing the Patcher may solve bugs or makes sure that applications that were installed after applying the WinTango Patcher for the first time get modified, too. Another purpose is to fulffill the urge to change the icon theme. To do so you only have to pick the desired icon theme and hit "Re-Install".
+3. This section gives you some options to stay up to date:
+
+To manually check for updates via this CPL Tool hit "Check now".
+
+If the installed version is the same as the Version on the server, it is indicated by turning the installed version text green. No further steps are taken.
+
+If the installed version differs from the latest version online, it is indicated by the color red. To apply this new version you can now hit the new "Apply Update" button to do so. This will download the latest installer and run it afterwards to install this new version.
+
+Automatically checking for Updates on system startup presents you with a Dialog to Update everytime there is a new version available.
+
+4. This section more or less explains itself: By clicking "Uninstall", the Uninstaller will restore all modifications to its original state and completely remove all of the Patchers files.
+
+### Help Tab
+
+1. Visit this Readme Page to learn about the WinTango Patcher and all of its options.
+1. If you're having problems, it's probably something I haven't anticipated; If I had thought of it, I would have either documented or coded a workaround for it. So, if you encounter a problem you please file a Bug Report by clicking on this button.
+
+### About Tab
+
+This Page provides some basic information on the WinTango Patcher and links to contact me. 

wiki/help/options_reloader.txt

@@ -0,0 +1,4 @@
+# Reloader
+
+If you checked "Run the Reloader on startup" this handy little tool will be executed at system startup and check for modified files to re-patch. This makes sure that for example after system updates the theme won't be broken.
+You can also run the Reloader manually via the Control Panel App whenever you want. 

wiki/help/options_uninstaller.txt

@@ -0,0 +1,3 @@
+# Uninstaller 
+
+To remove all modifications and files of the WinTango Patcher, it includes an Uninstaller which should do the job for you. Sometimes there may be some [leftovers](https://github.com/heebijeebi/WinTango-Patcher/wiki/Problems:-Incomplete-Uninstallation), which can be safely removed after running the Uninstaller and rebooting Windows.

wiki/help/options_updater.txt

@@ -0,0 +1,3 @@
+# Updatechecker
+
+From time to time I will release a new version of the WinTango Patcher, which may include new features or further improvements on existing modifications. Anyway, to make sure you stay up to date you can either set the Updatechecker to run on startup (see Setup Options) or manually run it via the Control Panel App. 

wiki/help/text-x-install.svg

@@ -0,0 +1,338 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="48px"
+   height="48px"
+   id="svg3962"
+   version="1.1"
+   inkscape:version="0.48.2 r9819"
+   sodipodi:docname="application-install.svg">
+  <defs
+     id="defs3964">
+    <inkscape:perspective
+       sodipodi:type="inkscape:persp3d"
+       inkscape:vp_x="0 : 24 : 1"
+       inkscape:vp_y="0 : 1000 : 0"
+       inkscape:vp_z="48 : 24 : 1"
+       inkscape:persp3d-origin="24 : 16 : 1"
+       id="perspective56" />
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3924"
+       id="linearGradient3114"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="translate(2.4e-6,0.9674491)"
+       x1="23.99999"
+       y1="4.999989"
+       x2="23.99999"
+       y2="43" />
+    <linearGradient
+       id="linearGradient3924">
+      <stop
+         id="stop3926"
+         style="stop-color:#ffffff;stop-opacity:1;"
+         offset="0" />
+      <stop
+         offset="0.06316455"
+         style="stop-color:#ffffff;stop-opacity:0.23529412;"
+         id="stop3928" />
+      <stop
+         id="stop3930"
+         style="stop-color:#ffffff;stop-opacity:0.15686275;"
+         offset="0.95056331" />
+      <stop
+         id="stop3932"
+         style="stop-color:#ffffff;stop-opacity:0.39215687;"
+         offset="1" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient2490-3"
+       id="linearGradient4110"
+       x1="25.075518"
+       y1="45.914536"
+       x2="25.075518"
+       y2="6.4426208"
+       gradientUnits="userSpaceOnUse" />
+    <linearGradient
+       id="linearGradient2490-3">
+      <stop
+         id="stop2492-3"
+         style="stop-color:#365f0e;stop-opacity:1"
+         offset="0" />
+      <stop
+         id="stop2494-8"
+         style="stop-color:#84a718;stop-opacity:1"
+         offset="1" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient2490-3-7"
+       id="linearGradient4110-9"
+       x1="25.075518"
+       y1="45.914536"
+       x2="25.075518"
+       y2="6.4426208"
+       gradientUnits="userSpaceOnUse" />
+    <linearGradient
+       id="linearGradient2490-3-7">
+      <stop
+         id="stop2492-3-7"
+         style="stop-color:#365f0e;stop-opacity:1"
+         offset="0" />
+      <stop
+         id="stop2494-8-5"
+         style="stop-color:#84a718;stop-opacity:1"
+         offset="1" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient2490-3-1"
+       id="linearGradient4110-5"
+       x1="25.075518"
+       y1="45.914536"
+       x2="25.075518"
+       y2="6.4426208"
+       gradientUnits="userSpaceOnUse" />
+    <linearGradient
+       id="linearGradient2490-3-1">
+      <stop
+         id="stop2492-3-3"
+         style="stop-color:#365f0e;stop-opacity:1"
+         offset="0" />
+      <stop
+         id="stop2494-8-0"
+         style="stop-color:#84a718;stop-opacity:1"
+         offset="1" />
+    </linearGradient>
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3242-7"
+       id="radialGradient3117"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(1.9428467e-8,2.33699,-2.4722567,-4.3056275e-8,44.890102,-11.46736)"
+       cx="7.4956832"
+       cy="8.4497671"
+       fx="7.4956832"
+       fy="8.4497671"
+       r="19.99999" />
+    <linearGradient
+       id="linearGradient3242-7">
+      <stop
+         id="stop3244-5"
+         style="stop-color:#eef87e;stop-opacity:1"
+         offset="0" />
+      <stop
+         id="stop3246-9"
+         style="stop-color:#cde34f;stop-opacity:1"
+         offset="0.26238" />
+      <stop
+         id="stop3248-7"
+         style="stop-color:#93b723;stop-opacity:1"
+         offset="0.66093999" />
+      <stop
+         id="stop3250-8"
+         style="stop-color:#5a7e0d;stop-opacity:1"
+         offset="1" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient2490-3"
+       id="linearGradient3119"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="translate(-6e-7,0.9674391)"
+       x1="24"
+       y1="44"
+       x2="24"
+       y2="3.8990016" />
+    <radialGradient
+       cx="4.9929786"
+       cy="43.5"
+       r="2.5"
+       fx="4.9929786"
+       fy="43.5"
+       id="radialGradient2873-966-168"
+       xlink:href="#linearGradient3688-166-749"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(2.003784,0,0,1.4,27.98813,-17.4)" />
+    <linearGradient
+       id="linearGradient3688-166-749">
+      <stop
+         id="stop2883"
+         style="stop-color:#181818;stop-opacity:1"
+         offset="0" />
+      <stop
+         id="stop2885"
+         style="stop-color:#181818;stop-opacity:0"
+         offset="1" />
+    </linearGradient>
+    <radialGradient
+       cx="4.9929786"
+       cy="43.5"
+       r="2.5"
+       fx="4.9929786"
+       fy="43.5"
+       id="radialGradient2875-742-326"
+       xlink:href="#linearGradient3688-464-309"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(2.003784,0,0,1.4,-20.01187,-104.4)" />
+    <linearGradient
+       id="linearGradient3688-464-309">
+      <stop
+         id="stop2889"
+         style="stop-color:#181818;stop-opacity:1"
+         offset="0" />
+      <stop
+         id="stop2891"
+         style="stop-color:#181818;stop-opacity:0"
+         offset="1" />
+    </linearGradient>
+    <linearGradient
+       x1="25.058096"
+       y1="47.027729"
+       x2="25.058096"
+       y2="39.999443"
+       id="linearGradient2877-634-617"
+       xlink:href="#linearGradient3702-501-757"
+       gradientUnits="userSpaceOnUse" />
+    <linearGradient
+       id="linearGradient3702-501-757">
+      <stop
+         id="stop2895"
+         style="stop-color:#181818;stop-opacity:0"
+         offset="0" />
+      <stop
+         id="stop2897"
+         style="stop-color:#181818;stop-opacity:1"
+         offset="0.5" />
+      <stop
+         id="stop2899"
+         style="stop-color:#181818;stop-opacity:0"
+         offset="1" />
+    </linearGradient>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="7"
+     inkscape:cx="24.428571"
+     inkscape:cy="24"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     inkscape:grid-bbox="true"
+     inkscape:document-units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1056"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1" />
+  <metadata
+     id="metadata3967">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     id="layer1"
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer">
+    <g
+       style="display:inline"
+       id="g2036"
+       transform="matrix(1.1,0,0,0.4444449,-2.4000022,25.11107)">
+      <g
+         style="opacity:0.4"
+         id="g3712"
+         transform="matrix(1.052632,0,0,1.285713,-1.263158,-13.42854)">
+        <rect
+           style="fill:url(#radialGradient2873-966-168);fill-opacity:1;stroke:none"
+           id="rect2801"
+           y="40"
+           x="38"
+           height="7"
+           width="5" />
+        <rect
+           style="fill:url(#radialGradient2875-742-326);fill-opacity:1;stroke:none"
+           id="rect3696"
+           transform="scale(-1,-1)"
+           y="-47"
+           x="-10"
+           height="7"
+           width="5" />
+        <rect
+           style="fill:url(#linearGradient2877-634-617);fill-opacity:1;stroke:none"
+           id="rect3700"
+           y="40"
+           x="10"
+           height="7.0000005"
+           width="28" />
+      </g>
+    </g>
+    <rect
+       style="color:#000000;fill:url(#radialGradient3117);fill-opacity:1;fill-rule:nonzero;stroke:url(#linearGradient3119);stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;stroke-dashoffset:0;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect5505-21"
+       y="5.4674392"
+       x="4.5"
+       ry="2"
+       rx="2"
+       height="39"
+       width="39" />
+    <path
+       sodipodi:type="inkscape:offset"
+       inkscape:radius="2.9088786"
+       inkscape:original="M 19 17 L 19 26 L 14.5 26 L 24 37 L 33.5 26 L 29 26 L 29 17 L 19 17 z "
+       style="opacity:0.05;color:#000000;fill:url(#linearGradient4110-5);fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.98542732;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="path3932-8-3"
+       d="M 18.71875,14.09375 A 2.9091695,2.9091695 0 0 0 16.09375,17 l 0,6.09375 -1.59375,0 a 2.9091695,2.9091695 0 0 0 -2.1875,4.8125 l 9.5,11 a 2.9091695,2.9091695 0 0 0 4.375,0 l 9.5,-11 A 2.9091695,2.9091695 0 0 0 33.5,23.09375 l -1.59375,0 0,-6.09375 A 2.9091695,2.9091695 0 0 0 29,14.09375 l -10,0 a 2.9091695,2.9091695 0 0 0 -0.28125,0 z"
+       transform="translate(0,-0.9995797)" />
+    <path
+       sodipodi:type="inkscape:offset"
+       inkscape:radius="2.0260036"
+       inkscape:original="M 19 17 L 19 26 L 14.5 26 L 24 37 L 33.5 26 L 29 26 L 29 17 L 19 17 z "
+       style="opacity:0.1;color:#000000;fill:url(#linearGradient4110-9);fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.98542732;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="path3932-8"
+       d="M 18.8125,14.96875 A 2.0262062,2.0262062 0 0 0 16.96875,17 l 0,6.96875 -2.46875,0 a 2.0262062,2.0262062 0 0 0 -1.53125,3.34375 l 9.5,11 a 2.0262062,2.0262062 0 0 0 3.0625,0 l 9.5,-11 A 2.0262062,2.0262062 0 0 0 33.5,23.96875 l -2.46875,0 0,-6.96875 A 2.0262062,2.0262062 0 0 0 29,14.96875 l -10,0 a 2.0262062,2.0262062 0 0 0 -0.1875,0 z"
+       transform="translate(0,-0.9995797)" />
+    <path
+       sodipodi:type="inkscape:offset"
+       inkscape:radius="1.0547382"
+       inkscape:original="M 19 17 L 19 26 L 14.5 26 L 24 37 L 33.5 26 L 29 26 L 29 17 L 19 17 z "
+       style="opacity:0.25;fill:url(#linearGradient4110);fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.98542732;marker:none;visibility:visible;display:inline;overflow:visible"
+       id="path3932"
+       d="M 18.90625,15.9375 A 1.0548436,1.0548436 0 0 0 17.9375,17 l 0,7.9375 -3.4375,0 a 1.0548436,1.0548436 0 0 0 -0.8125,1.75 l 9.5,11 a 1.0548436,1.0548436 0 0 0 1.625,0 l 9.5,-11 A 1.0548436,1.0548436 0 0 0 33.5,24.9375 l -3.4375,0 0,-7.9375 A 1.0548436,1.0548436 0 0 0 29,15.9375 l -10,0 a 1.0548436,1.0548436 0 0 0 -0.09375,0 z"
+       transform="translate(0,-0.9995797)" />
+    <path
+       id="path3288-2"
+       d="m 32.5,25.500421 -8.5,10 -8.5,-10 4,0 0,-9 9,0 0,9 4,0 z"
+       style="fill:#f7f7f7;stroke:#ffffff;stroke-width:0.98542732000000000;stroke-opacity:1;marker:none;visibility:visible;display:inline;overflow:visible;fill-opacity:1"
+       sodipodi:nodetypes="cccccccc" />
+    <rect
+       style="opacity:0.5;fill:none;stroke:url(#linearGradient3114);stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;stroke-dashoffset:0"
+       id="rect6741-2"
+       y="6.4674392"
+       x="5.5"
+       ry="1"
+       rx="1"
+       height="37"
+       width="37" />
+  </g>
+</svg>