Skip to content

Latest commit

 

History

History
172 lines (140 loc) · 5.8 KB

README.md

File metadata and controls

172 lines (140 loc) · 5.8 KB

Dark7zip

7z Build status Latest release Total downloads License PayPal.me

Dark7zip is project to experiment with dark mode using win32 API.
It is mainly for Windows 10 and Windows 11. Some controls might, might not use dark/custom colors on older OS.



Installation

Replace 7z original files (e.g. C:\Program Files\7-Zip\) with files from downloaded zip file (currently only for x64 platform).

  • 7zFM.exe - file manager, "main exe"
  • 7zG.exe - mainly extraction, compression dialogs
  • 7z.sfx- optional, file needed for creating self-extracting archives
  • 7zDark.ini - optional, more information below

Config

7zDark.ini is configuration file to allow mainly to set custom colors. 7zDark.ini should be in same folder as 7zFM.exe and 7zG.exe.

  • [main]

    • mode - determine which sections color "key=value" pairs will be used and theming of title bar, buttons, scrollbars, and tooltips
      • 0 - use light mode
      • 1 - use dark mode, default value
      • 2 - follow system settings
  • [dark]

    • tone - set default colors for [dark.colors] sections, there are no tones for light mode
      • 0 - black, default value
      • 1 - red
      • 2 - green
      • 3 - blue
      • 4 - purple
      • 5 - cyan
      • 6 - olive
    • micaExtend - apply Mica material on all window/dialog, experimental, only for "dark" mode
      • 0 - apply Mica material only on title bar, default value
      • 1 - extend Mica material on all window/dialog

Important

micaExtend=1 is only used with [main] mode=1 and with mica with other valid values than 0. micaExtend=1 should also be used with HDR and ACM (Auto Color Management) off. Due to Windows bug using micaExtend=1 can cause visual glitches, with HDR/ACM visual glitches are more severe (e.g. invisible controls).
It is also recommended when using with mica=1 to turn off Settings -> Personalization > Colors -> "Show accent color on title bars and window borders" setting.

  • [dark]/[light]
    • mica - apply Mica material on title bar, requires Windows 11 22H2 build 22621
      • 0 - let OS automatically decide the use of Mica material, default value
      • 1 - do not use Mica material
      • 2 - apply Mica material
      • 3 - apply "acrylic" effect
      • 4 - apply Mica Alt material

Values for custom colors are in RGB hex format - RRGGBB.

  • [dark.colors]/[light.colors]

    • background - for some controls (status bar, ...)
    • backgroundInteractive - mainly for controls with some input
    • backgroundHot - for hot item
    • backgroundDlg - for dialog and some controls
    • text - for most text
    • textItem - for some controls
    • textDisabled - for disabled controls
    • edge - for border
    • edgeHot - for hot border
    • edgeDisabled - for disabled border
  • [dark.colors.view]/[light.colors.view] - for listview and treeview

    • backgroundView
    • textView
    • gridlines - color for listview grid lines, when View -> Details is used and Tools -> Options... -> Settings tab -> Show grid lines is checked
    • backgroundHeader
    • backgroundHotHeader
    • textHeader
    • edgeHeader

All options are optional. You can define only "[section]" and "key=value" you want to be applied.

Tip

Renaming section will disable all "key=value" pairs of that section and default values will be used.

Examples:

  • full config
[main]
mode = 1

[dark]
tone = 0
mica = 0
micaExtend = 0

[dark.colors]
background =            "202020"
backgroundInteractive = "404040"
backgroundHot =         "404040"
backgroundDlg =         "202020"
text =                  "E0E0E0"
textItem =              "C0C0C0"
textDisabled =          "808080"
edge =                  "646464"
edgeHot =               "9B9B9B"
edgeDisabled =          "484848"

[dark.colors.view]
backgroundView =        "293134"
textView =              "E0E2E4"
gridlines =             "646464"
backgroundHeader =      "202020"
backgroundHotHeader =   "404040"
textHeader =            "C0C0C0"
edgeHeader =            "646464"

[light]
mica = 0

[light.colors]
background =            "F0F0F0"
backgroundInteractive = "FFFFFF"
backgroundHot =         "C0DCF3"
backgroundDlg =         "F0F0F0"
text =                  "000000"
textItem =              "000000"
textDisabled =          "6D6D6D"
edge =                  "8D8D8D"
edgeHot =               "0078D4"
edgeDisabled =          "6D6D6D"

[light.colors.view]
backgroundView =        "FFFFFF"
textView =              "000000"
gridlines =             "F0F0F0"
backgroundHeader =      "FFFFFF"
backgroundHotHeader =   "D9EBF9"
textHeader =            "000000"
edgeHeader =            "E5E5E5"
  • only views, with defaults: [main] mode=1, and [dark] tone=0
[dark.colors.view]
backgroundView =        "112435"
textView =              "C3BE98"
gridlines =             "4F5F5F"

License

Most code related to dark mode is under license MIT, or GPLv3 or later version.

For 7-Zip check DOC folder for information on used license.
License.txt
readme.txt

7-Zip on GitHub

7-Zip website: 7-zip.org