🎏 ImageGlass theme packs

The up-to-date theme packs for ImageGlass

⌚ Change history

This instruction is always for the latest version of ImageGlass. If you are using the older versions, please see the changes (if any) at:

https://github.com/ImageGlass/theme/releases

🪐 Naming convention

Please follow this naming convention for your theme folder and theme pack:

Theme folder (THEME_FOLDER)

<theme_name>.<author>

While:

• theme_name: The name of the theme, no space, separated by comma ,.
• author: The author of the theme, no space, separated by comma ,.

For example: Kobe.Duong-Dieu-Phap, 2017-Light-Gray.Duong-Dieu-Phap.

Theme pack

Similar to "Theme folder" but with the extension:

<theme_name>.<author>.igtheme

For example: Kobe.Duong-Dieu-Phap.igtheme, 2017-Light-Gray.Duong-Dieu-Phap.igtheme.

📂 Theme pack folder structure

A theme pack folder contains:

• 1 igtheme.xml file
• 1 preview image file
• And SVG icon files

All of these files should be placed in a folder:

THEME_FOLDER
|-- igtheme.xml
|-- preview image file
|-- SVG icon files...

🎨 How to create a new theme pack?

1. Create theme pack folder structure

2. Create igtheme.xml file

This is the most important file of the theme, it provides all the SVG icon files to ImageGlass app and other information of your theme. You can see full igtheme.xml example at https://github.com/ImageGlass/theme/blob/master/themes/dark/2017_dark/igtheme.xml

There are 3 sections in <Theme> element:

<ImageGlass>
  <Theme>
    <Info />
    <main />
    <toolbar_icon />
  </Theme>
</ImageGlass>

2.1 <Info /> element

Provides general information of your theme packs, all options are:

Full example:

<Info name="Kobe"
    version="8.0"
    author="Duong Dieu Phap"
    email="[email protected]"
    website="https://imageglass.org"
    description="Modern ImageGlass theme"
    type="ImageGlass Theme Configuration"
    configversion="8.0"
    preview="preview.jpg" />

2.2 <main /> element

Provides color scheme of ImageGlass. It should be either decimal color code or HEX code (no alpha value). All options are:

Full example:

<main topbar=""
    bottombar=""
    topbarcolor="#3a3c3d"
    bottombarcolor="#3a3c3d"
    backcolor="#3a3c3d"
    statuscolor="#f0f0f0"
    menubackgroundcolor="#484b4c"
    menutextcolor="#f0f0f0" />

2.3 <toolbar_icon /> element

Provides icons for toolbar. It's recommended to use SVG file format for better scaling on high DPI screens. All options are:

3. Add icons and image files

4. Add preview image file for your theme (step 2.1)

5. Pack your theme

• Zip the whole theme folder as .zip.
• Change the .zip extension to .igtheme.

6. Share your theme

After creating a nice theme, don't forget sharing it to other people. You can

• Create an issue here, and attach your awesome theme; or
• Send your theme pack (.igtheme) to [email protected] email.

💖 Support this project

ImageGlass is free and open source but developing it has taken thousands of hours of my time and a large part of my sanity. If you feel this little viewer useful to you, it would go a great way to ensuring that I can afford to take the time to continue to develop it.

Thanks for your gratitude and finance help!

Cryptocurrency donation:

# Ethereum
0xc19be8972809b6b989f3e4ba16595712ba8e0de4

# Bitcoin
1PcCezBmM3ahTzfBBi5KVWnnd3bCHbas8Z

❤

Thank you!