Git Product home page Git Product logo

translucenttb's Introduction

TranslucentTB

Liberapay patrons Join on Discord Join on Gitter Total downloads Build Status CodeFactor

With regards to the malware allegations, we have an Issue explaining our permissions use.

A lightweight (uses a few MB of RAM and almost no CPU) utility that makes the Windows taskbar translucent/transparent on Windows 10.

You can see examples of the customizations you can make in the images below:

blur transparent acrylic

Features

  • Advanced color picker supporting alpha and live preview to change the taskbar's color.
  • Taskbar states (choose one - color can be customized on every state except Normal):
    • Blur: Will make the taskbar slightly blurred.
    • Clear: Transparent taskbar.
    • Normal: Regular Windows style. (as if TranslucentTB was not running)
    • Opaque: No transparency.
    • Fluent: Windows 10 April 2018 update and up only. Will give the taskbar an appearance similar to Microsoft's Fluent Design guidelines.
  • Dynamic modes (these can be used together and each of them provides a taskbar state and color you can customize):
    • Dynamic Windows: Will change the taskbar to a different appearance if a window is currently maximised.
    • Dynamic Start Menu: Will change the taskbar appearance when the start menu is opened.
    • Dynamic Cortana: Will change the taskbar appearance when Cortana (or the search menu if Cortana is disabled) is open.
    • Dynamic Timeline/Task View: Will change the taskbar apperance when the Timeline (or Task View on older builds) is open.
  • Ability to show or hide the Aero Peek button. Can be customized at will or dynamic.

You can see it in action here (short) and here (longer).

Download

You can download the program freely from the Microsoft Store and take advantage of its features like background auto-updates and settings sync.

If you prefer a classical download, you can do so via the releases tab.

If you want to get the latest bleeding edge build, you can grab it over at the Azure Pipelines page. Note that these build may not work, or include features that are partially complete. Use at your own risk.

Add to Startup

To add TranslucentTB to startup, check the "Open at boot" entry in the TranslucentTB tray icon's context menu. If it is grayed out, TranslucentTB startup has been disabled from within the Task Manager or by your organization.

Donations

We have a Liberapay! Don't hesitate to donate if you appreciate TranslucentTB and would like to support our work.

Security

Some antiviruses are over eager, so they might flag this program as malicious. IT IS NOT! Over 200k users have downloaded this program safely. The source is open, you can compile it yourself, and I welcome any and all security reviews.

Speaking of compiling...

Building from source

You can checkout one of the available branches. However, it is recommended to use release, as the code here is stable and has been passed through peer review.

Via git:

$ git clone -b [branch-you-want] https://github.com/TranslucentTB/TranslucentTB
Cloning into 'TranslucentTB'...
remote: Counting objects: 909, done.
remote: Compressing objects: 100% (40/40), done.
remote: Total 909 (delta 44), reused 61 (delta 35), pack-reused 834
Receiving objects: 100% (909/909), 383.94 KiB | 2.78 MiB/s, done.
Resolving deltas: 100% (624/624), done.

You can also download a zip archive of each branch by clicking on the Clone or download button while browsing the branch's files.

Now that you have the source, you will need Visual Studio 2017. You can get the free community edition here. Check the following workloads:

  • Desktop development with C++
  • .NET desktop development

You also need to install the following individual components:

  • Any of the VC++ 2017 toolsets (latest prefered)
  • Windows 10 SDK (10.0.17134.0)
  • .NET Framework 4.6.2 SDK
  • .NET Framework 4.6.2 targeting pack

You also need the Clang compiler for Windows and Inno Setup.

Once you have that installed, open TranslucentTB.sln, and press Ctrl+Shift+B to build the solution.

The output will be in either the Debug or Release folder (depending on which solution configuration is currently active).

To build the desktop installer, run the DesktopInstallerBuilder project.

To build the Microsoft Store app package, build the solution with the Store configuration.

Contributing

If you would like to contribute, everyone is welcome to! If you are considering a major feature, need guidance, or want to talk an idea out, don't hesitate to jump on Discord, Gitter, or file an issue here. The main contributors are often on Discord, Gitter and GitHub, so we should reply fairly quickly. At this time we have no plans of expanding this beyond the taskbar.

When contributing, please respect the style used by the codebase. Quick rundown:

  • Allman braces everywhere, even on one line blocks:

    // Bad!
    if (condition) {
        statement;
    }
    
    // Bad!
    if (condition) statement;
    
    // Bad!
    if (condition)
        statement;
    
    // Good!
    if (condition)
    {
        statement;
    }
  • The only exception to this rule is the opening brace of a class, enumeration, namespace or structure, in which K&R braces apply:

    class Foo {
        // content
    };
    
    struct Bar {
        // content
    };
    
    namespace Baz {
        // content
    }
    
    enum Foobar {
        // content
    };
  • lvalue, rvalue and pointer qualifiers are next to the variable name:

    std::wstring &foo;
    std::wstring &&bar;
    std::wstring *baz;
  • Indentation style is 4 spaces large tabs, and your editor should enforce it with this repo's .editorconfig automatically.

When trying to debug the main program, it might seem confusing at first because the two projects listed for launch in the header are StorePackage and DesktopInstallerBuilder. Just right-click the TranslucentTB project and select "Set as startup project".

Thanks

TranslucentTB is a team effort! It is the result of the collective efforts of many people:

Thanks to @dAKirby309 for making the icon! You can find more of his stuff on his DeviantArt profile.

The color picker used comes from this great CodeProject article. We've modernized it a bit, with per-monitor high DPI awareness, faster (and hardware-accelerated) drawing as well as allowing to input any valid HTML color code or name.

The picture we used for the installer screenshot is by Michael D Beckwith from Unsplash.

We use Inno Setup Dependency Installer to install the Visual C++ redistribuable.

Similar programs

If you are looking for something that modifies more than just the taskbar, there are several programs out there.

Taskbar Tools is a similar program written in C#. However, it seems to be unmaintaned.

You may have seen similar translucency abilities from programs such as StartIsBack, Start10 and the now defunct Classic Shell. All of these are great programs, but I don't need the start-replacement features, so I wrote this. TranslucentTB also allows for more customizability over the taskbar with features such as Dynamic Windows, Dynamic Peek and Dynamic Start that these programs don't have. The storage and memory impact is also lesser.

License

This program is free (as in speech) software under the GPLv3. Please see the LICENSE.md file for more.

translucenttb's People

Contributors

ethanhs avatar ghost1372 avatar gitter-badger avatar mraksel avatar olliecheng avatar sylveon avatar wasdennnoch avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.