/SublimeTextTrans

A Sublime Text 2 & 3 Plugin to set the application opacity on Windows

Primary LanguagePythonMIT LicenseMIT

SublimeText Transparent

Package Name : Transparency

Overview

This simple plugin for Sublime Text 2 and Sublime Text 3 provides contextual menues and hotkeys to modify the application's opacity.

This is only for SublimeText under Windows.

Install

Using Package Installer:

Ctrl+Shift+P - Install Package - Transparency

You may also install SublimeTextTrans via git with the below commands:

Windows only

For Sublime Installed:

git clone https://github.com/vhanla/SublimeTextTrans.git "%APPDATA%\Sublime Text 2\Packages\Transparency"

Notice that this location might change on each SublimeText version, you can find the correct path by going to menu Preferences - Browse Packages

For Sublime as Portable:

git clone https://github.com/vhanla/SublimeTextTrans.git "C:\Sublime\Data\Packages\Transparency"

Where C:\Sublime is the portable's path. So change accordingly.

You can also get it zipped from the Releases section.

Remember, this plugin must be inside its own directory within packages directory where you will unzip it.

Usage:

There are three methods to set transparency:

  1. Visit View > Window's Transparency submenu to set the opacity
  2. You can use the hotkeys Ctrl+Shift+[1,2,3,4,5,6]
  3. Or you can right click and use the contextual menu

Limitations:

  • Only 6 levels of transparency, [0 = invisible <-> 255 = solid] customizable on settings file.
  • It requires another executable to change Sublime Text's window style mode to allow translucency. However, you don't need to install it or launch manually, the plugin does it for you. Executable is only a 1024 bytes and source code is included, which is in assembler language, hence that's why it is so small. Also, it is launched only once each time you start Sublime Text, and it closes itself after changing style, so no memory is used afterwards.

Changelog:

[16-05-2018] v1.4

  • Fixed opening default settings and help menu
  • Improved window listing on ST3
  • Fixed issue #3 thanks to @rexdf
  • Only call external executable if ST2/3 window is not already WS_EX_LAYERED

[14-04-2018] v1.3

  • Modified SetSublimeLayered.asm to make it smaller and to avoid false positives (tested on VirusTotal)

These are SetSublimeLayered.exehashes:

- SHA-256	66b72c28f54728c6df3995b0ae026aa1aeeca96911d5b484673a502ec6592f2a
- CRC32		54612762
- MD5 		E113BDC6FA08BC054F7A89E7B24411BD
- SHA-1 	376707D5579384B42586D0616BB03BBB993C6050

[15-24-2015] v1.2

  • Onload transparency (95% working due to ST API limitations)
  • Remember chosen transparency level
  • Support for user settings

[12-06-2013] v1.0

  • Added support for Sublime Text 3

Configuration:

To set custom transparency levels visit Preferences > Package Settings > SublimeTextTrans > Settings - User, it will open the user's custom preferences file for this plugin.

There you can modify the transparency levels, by adding the following and adjusting the levels as you wish:

{

	// If you like to have a different transparency level
	// modify this array of options in your user preferences
	// i.e. just add (copy/paste) this array and modify at wish
	// IMPORTANT: Level of opacity varies from 0 to 255
	// 0 = Totally transparent, 255 = Fully opaque
	"levels": [
		255, // Full opaque i.e not transparency - a.k.a Disabled
		212, // Level 5
		220, // Level 4
		228, // Level 3
		236, // Level 2
		243  // Level 1
	]
}

You can see other options on Settings - Default file.

Author & Contributors

License

The MIT License (MIT)

Copyright (c) 2013 Victor Alberto Gil

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.