## How To Install

Note: You will have to enable `view hidden folders` in your file manager to see hidden files.

Create a `.themes` folder in your user directory `/home/$USER/` if it doesn't already exist. (with $USER being your username.)

    mkdir -p ~/.themes

Copy the `Theme/Chicago95` folder into `.themes`.

    cp -r Theme/Chicago95 ~/.themes

Copy `Extras/override/gtk.css` file into `/home/$USER/.config/gtk-3.0/`.

    cp Extras/override/gtk.css ~/.config/gtk-3.0/

(Note 1: You may have to create the "gtk-3.0" directory if it's not there.)

    mkdir -p ~/.config/gtk-3.0

(Note 2: If you ever want to change your system theme to anything else, don't forget to remove the `gtk.css` override file! It makes adjustments based on this theme which might break other themes.)

Log out then log back after installing.

## Configuration

#### Enabling the GTK theme
Open the XFCE settings manager > Appearance.

- Choose Chicago95 as the theme style.

#### Enabling the Window Manager theme
Open the XFCE settings manager > Window Manager.

- Choose Chicago95.
- Set Title font to Sans Bold, 8 points.

#### Enabling the theme for QT5 applications (optional)
Open your terminal and install the qt5 style plugins package.

- sudo apt install qt5-style-plugins

Relogin for changes to take place.

#### Enabling the notification theme
Open the XFCE settings manager > Notifications.

- Choose Chicago95 for the theme.
- Adjust Opacity to 100%.

#### Setting up the XFCE panel
Open the XFCE settings manager > Panel

- Measurments: Even numbers are preffered for the Row Size slider. The smallest optimal panel row size for this theme is 26 pixels. If your panel is below that size, you will encounter icon scaling issues.
- Under the Appearance tab set the background style to "None (use system style.)"

Here's a list for the panel Items plugin layout as seen from the screen-shots. This is optional, the item configuration is up to you after all.

1. Application Menu or Whisker Menu;
2. Separator (Handle Style);
3. Custom Launcher, Custom Launcher, Custom Launcher, etc;
4. “Show Desktop” plugin;
5. Separator (Handle Style);
6. Window Buttons (Uncheck "Show flat buttons" and "Show Handle.;" Sorting Order: None; Window grouping: Never);
7. Separator (Transparent with Expanding);
8. Separator (Handle Style);
9. Indicator Plugin OR Notification Area (19px max icon size preferred);
10. Separator (Transparent);
11. Orage Panel Clock. (Enable check box “Show frame” and replace the text in “Line 1” with %I:%M %p.)

## Optional configurations
The following configurations are optional and not required but can be used to enhance the theme.

#### Whisker Menu and XFCE Application Menu Start Buttons
For XUbuntu 17.10, the Whisker Menu plugin is now GTK3. The Application Menu plugin is still GTK2. This will differ for other distributions.

#### • Whisker Menu
Open the XFCE settings manager > Panel > Items tab > Double click the Whisker menu item in the item list.

- In the whisker properties menu click the icon option.
- In the icon select window navigate to `/home/$USER/.themes/Chicago95/misc` (with $USER being your username.)

`misc/` contains simple small icons if you want a basic icon. These might be ideal for vertical deskbar panels.
`GTK3 start buttons/` contains start button icons.

Note: The smallest optimal panel row size for this theme is 26 pixels. If your panel is below that size, you will encounter icon scaling issues.

#### • Application Menu
Open the XFCE settings manager > Panel > Items tab > Double click the Applications Menu item in the item list.

- In the Applications properties menu click the icon option.
- In the icon select window navigate to `/home/$USER/.themes/Chicago95/misc` (with $USER being your username.)

`misc/` contains simple small icons if you want a basic icon. These might be ideal for vertical deskbar panels.
`GTK2 start buttons/` contains start button icons.

Since the Application Menu plugin is still GTK2, you'll have to choose an icon associated with your panel size. For example, tux_32px.png would be ideal on a panel with a row size of 32 pixels.

Note: The smallest optimal panel row size for this theme is 26 pixels. If your panel is below that size, you will encounter icon scaling issues.

#### Launcher Button scaling (advanced)
Note: This might be a little complicated since it's more of a work-around than a good solution. I tried making this as simple as possible where you will just adjust configurations in a file. If there are questions or issues with the following instructions, open a ticket and i'll try to walk you through it.

If you want to force 16x16px icons in the launcher buttons, you can do this by making your own custom icons or through the theme by editing the panel.rc file.

- Open a text editor and navigate to `/home/$USER/.themes/Chicago95/gtk-2.0/panel.rc` (with $USER being your username.)
- Move to line 250 of the file where you will see a section specified for Launcher buttons.

Example steps: You will first need to determine your current panel bar row size since the launcher button icon padding is determined by the vertical size of the panel bar.

- Open the XFCE settings manager > Panel
- Verify the "Row Size (pixels)". (Lets say that it's 38 pixels for this example.)
- Return back to the text editor and locate the line comment that is specifying your panel bar row size. (38px height panel for this example is on line 284.)
- Delete the "#" pound character in front of the xthickness and the ythickness values for the specified panel bar size.
- Now Insert a "#" pound character in front of the xthickness and the ythickness values of the previous default selection, which is for a 26px height panel.
- Save the file and reload the xfce panel bar. You can run `xfce4-panel -r` in a terminal to reload the panel.

Notes: Even numbered panel bar row sizes seem to work best. If your panel bar row size is "29px" for example, the launcher icons may not scale correctly.

If you use a vertical deskbar, you could add a second row from the panel properties menu to organize the launcher buttons into rows. This would have a more organized effect.

#### Shadows
Disable shadows in compositing for an authentic appearance, or at the very least disable “show shadows under dock windows” to prevent dark shading from the panel bar overlapping onto maximized applications.

- Open the XFCE settings manager > Window Manager Tweaks > Compositor tab
- Uncheck "Show shadows under pupup windows."
- Uncheck "Show shadows under dock windows."
- Uncheck "Show shadows under regular windows."

#### GTK Overlay Scrollbars
Note: You may have to enable `view hidden folders` in your file manager to see hidden files.

GTK Overlay Scrollbars can be disabled from the `.xsessionrc` file located in the `Extras/override` folder.

Copy the .xsessionrc file into your user directory `/home/$USER/` or append the contents if you already have a .xsessionrc file.

Log out then log back in.

#### Icons
To install the icons copy the folders `Icons/Chicago95` and `Icons/Chicago95-tux`to `~/.icons`.

In XFCE select Settings -> Appearance. Click on 'Icons' and select `Chicago95`.

#### Desktop icons (text shadows and label backdrop )(advanced)
If you want to change the icon label backdrop colour, text colours, or highlight colours you'll have to edit the gtkrc theme file located in `/home/$USER/.themes/Chicago95/gtk-2.0/`.

Text shadows can be modified from lines 553 to 559. These are currently commented out with "#."

Label backdrop colours can be modified on line numbers 565 to 570.

After any changes are made log out then log back in. You can use CSS colour properties as seen on line 551 for any colour you want.

#### Cursors
To install the cursors copy the folders in `Cursors` to `/usr/share/icons` or `~/.icons`.

In XFCE select Settings -> Mouse and Touchpad. Click on 'Icons' and select `Chicago95`.

Note: If you copied the icons to `/usr/share/icons` you may have to log out or reboot your system before the cursor theme is available.

#### Bash terminal Fonts
Copy the folder `Fonts/vga_font` to `~/.fonts/truetype/` if the `.fonts/truetype` folder doesn't exist just create it before you copy the files.

Update your font cache: sudo fc-cache -f -v

In xfce-term selet the font `Less Perfect DOS VGA` or `More Pefect DOS VGA`.

[Click here](https://int10h.org/oldschool-pc-fonts/fontlist/) for more classic fonts.

#### Bash terminal MS-DOS theme
Copy the file `Extras/Chicago95.theme` to `~/.local/share/xfce4/terminal/colorschemes` (create the colorschemes folder if it doesn't exist: `mkdir .local/share/xfce4/terminal`).
Under preferences in xfce-term select 'Colors.' Under `Presets` you should see `Chicago 95`.

To get the MS-DOS `C:\>` prompt and startup message add the contents of `Extras/DOSrc` to your `.bashrc` file: `cat Extras/DOSrc >> ~/.bashrc`.
To get MS-DOS Prompt title, go to the Preferences prompt and change title to MS-DOS Prompt and select isn't displayed on The Dynamically-Set Title

#### oh-my-zsh MS-DOS theme
Copy the file `Extras/Chicago95.zsh-theme` to `~/.oh-my-zsh/themes` (if you have changed your `.oh-my-zsh` config location, put the theme in that folder). In your `.zshrc` change your theme to Chicago95.

This will add the MS-DOS prompt. You will get a C prompt by default. If the previous command had an exit code other than 0 you will get an F prompt. If you are in a git repository you will git a G prompt, followed by the branch (in yellow) and the status (clean in green, dirty in red).

To get the startup message, add the contents of `Extras/ZSHDOSrc` to your `.zshrc` file: `cat Extras/ZSHDOSrc >> ~/.zshrc`.

#### Windows 95 login startup sound
Copy the file `Extras/Microsoft Windows 95 Startup Sound.ogg` to `/home/$USER/.themes/Chicago95/misc/Microsoft Windows 95 Startup Sound.ogg` or where ever you want.

##### XFCE
- Open XFCE Settings Manager > Session and Startup > Application Autostart tab
- Add a new entry
- Give it a name and a command similar to the following: `play /home/$USER/.themes/Chicago95/misc/Microsoft\ Windows\ 95\ Startup\ Sound.ogg`

##### LXDE
- Create the file `./config/autostart/chicago95.desktop` with the following contents:

```
[Desktop Entry]
Type=Application
Name=Chicago95 Chime
Comment=The Windows 95 startup sound
Exec=sh -c 'play /home/$HOME/.themes/Chicago95/misc/Microsoft\ Windows\ 95\ Startup\ Sound.ogg'
OnlyShowIn=LXDE
```