2 How To Install Styles and Scripts - cascadeth/OSU-IT-Tool-Mods GitHub Wiki

So you found a style or script that you like, here's how to install it!

Unless otherwise specified in a readme in the directory for the style or script, below will be the instructions for installing any style or script in this repository.

Steps for a style

  1. Install Stylus (you may need to restart you browser after adding it)

    1. If you're using Chrome (which you should be if you work at the Service Desk anyways) you can install Stylus through: here

  2. Find the style you would like to install (you have a few choices)

    • Back on the main page for the repository, there is a button that says "Find File" next to the green button that says "Clone or download". You can use this to search a theme name or submitter name and then find the file for the style you are looking for, and then copy its contents

    • To download the repository to your computer as a .zip file, hit the "Clone or download button", choose "Download ZIP", unzip the file once it's downloaded, and then look for the styles you want

    • "Advanced" method (this is recommended if you plan to submit your own code): Using Git! Honestly, will probably make a separate wiki page for howToGit.

  3. Open Stylus (will have image of icon later), and click "Create New Style"

    • If it is a non-Mozilla CSS style:

      1. Create a new style in Stylish.

      2. Paste the code from the theme that you wish to install into the code section.

      3. Enter a name and modify the "applies to" to match what is in the theme's README.

    • If it is a a Mozilla CSS style:

      1. Create a new style in Stylish.

      2. Hit "Import" on the left, paste the theme's code into the window, and then hit "Overwrite style" or "Append to style".

      3. Add a name, if needed. The "Applies to" should be set from the import.

  4. Hit save. You're done!

Steps for a script:

  1. Install tampermonkey

    Note: tampermonkey has extensions for both Chrome and Firefox. The Firefox version is called "Greasemonkey"

  2. Navigate to the script that you would like to install in this repository and open it up.

  3. Click on the button that says "Raw".

  4. Click "Install". This completes the tampermonkey script installation.

NOTE: If you do not see the "Install" button on this page then the script probably isn't a ".user.js" file and therefore does not interface with tampermonkey's installer.

Exporting and Importing Scripts

Once you have all of the tampermonkey scripts that you normally use installed, you can export them as a script file. This allows you to import all of the scripts at the same time using that file later, which is much faster than installing them one by one through github.

Exporting:

  1. Open the tampermonkey dashboard by clicking on the extension icon and then clicking "dashboard" that appears near bottom of the dropdown menu.

  2. Click on the "Utilities" tab of the dashboard.

  3. Under "File" (or whatever method you want to use to export) click "Export"

  4. Save the file that it exports. Any file location that can be accessed from any computer is a good place for this. Your personal network drive is a good example.

Importing:

  1. Open the tampermonkey dashboard by clicking on the extension icon and then clicking "dashboard" that appears near bottom of the dropdown menu.

  2. Click on the "Utilities" tab of the dashboard.

  3. Under "File" (or whatever method you want to use to export) click "Choose File".

  4. Select your export file.

  5. Click "Import" at the top of the tampermonkey window after it detects all of your scripts to import.