Code Monkey home page Code Monkey logo

openbar's Introduction

Open Bar (GNOME 4X Extension)

A GNOME Shell extension for customizing Gnome Top Bar / Top Panel, menus and more.

Customize:

  • Auto-theming options (Color, Dark, Light)
  • Bar Type: Fixed, Floating or Islands / Trilands
  • Bar position, height, margin, paddings
  • Bar foreground color, font
  • Bar background color, transparency, gradient, shadow, highlights, candybar
  • Shape rectangular to pill, border width, color, neon glow
  • Menu customizations: foreground / background colors, transparency, border, shadow, active/selection, hover colors etc.
  • Apply to notification popups
  • Includes a custom color palette in each color button popup. The palette is auto-generated from the desktop background.
  • Import, export theme settings to file.
  • Window-Max Bar: Change Bar props when a window is maximized
  • More settings in Menus: Menu panel and buttons radius, slider tweaks

Auto Theming:

  • Note: If you want to save your current settings, please use Export Settings option before applying Auto-theme. You can import it back whenever needed.
  • Please select Bar properties esp. type of bar before applying a theme. If you change Bar type later, apply theme again.
  • There are three theme options: 'Color', 'Dark', 'Light' and two variations for each: 'Default', 'Alt'. Try all combinations to see what you prefer for your desktop background. (Default and Alt maybe very similar or distinct depending on the background palette).
  • There are more settings in Auto-Theme. You can select if you want the secondary menu BG color to be derived from BG or auto-selected from palette. Also, you can specify any preferred accent color or let the theme choose from the background.
  • Since it is one size fit all solution, 'No Free Lunch' theorem applies. Not all options will work for all backgrounds, so the additional knobs above will help you select the desired one. One of the combinations should work for you at least with little bit tweaking if needed.
  • Once theme is applied, you can further tweak any of the manual settings as usual to finetune the theme.
  • There is an option for Auto-refreshing theme when background changes. This will overwrite current theme with newly generated one when background is changed.

Installation

Recommended

It's recommended to install the extension from extensions website, or from the Extension Manager app.

How to manually install the extension (if needed)?

git clone https://github.com/neuromorph/openbar.git \
	~/.local/share/gnome-shell/extensions/openbar@neuromorph

OR download the release zip file (may not be latest) and unzip at location: ~/.local/share/gnome-shell/extensions/

You may need to restart the gnome shell environnment (for manual install):

  • logout and login again (Do this if using Wayland) or
  • alt+f2 then type r and enter

Settings Notes

Use the settings panel of the extension for customizations. If the panel/menu isn't looking right, you need to tweak some settings. There are a lot of knobs to allow for differnt setups/tastes. It can also make it a bit overwhelming if you are not familiar with css styles but with some experimentation it will become a lot easier. Here are brief notes:

  • BG/FG color: Background or Foreground colors. Foreground is typically text and icons.
  • Alpha: Transparency for the color. 0 is transparent while 1 is opaque.
  • Panel BG will affect the bar while Tri/Islands BG will affect the individual indicator buttons/combos (in Trilands/Islands mode).
  • Gradient goes from Start color to End color. If you want a single color fading, select same color for both with differnt Alphas. e.g. Setting end color alpha to 0 will form a gradient from Start color to transparent.
  • Highlight color: It is the background color upon hover or focus. You can choose to highlight with border instead.
  • Vertical padding: Controls size of highlights in Mainland/Floating. Also controls size of Islands/Trilands. Increase height if padding squeezes the text.
  • Panel Shadow: a downward shadow for the panel bar. Shadow Spread controls both shadow trasparency and spread together.
  • Border:
    • Width controls thickness (grows inwards for Islands). Adjust bar height accordingly, after setting border width.
    • Radius will control the shape from rectangle at radius 0 to Pill at radius close to bar height.
    • Neon glow: adds a neon-light like glow to the border. You need dark, relatively opaque background with bright/neon colored, relatively opaque border. Neon will override Panel shadow in Mainland and Floating mode.
  • Menus:
    • FG/BG, border, highlight are similar to above but for menus.
    • Accent/active color is for menu items that are active e.g. Today's day in Calendar or WiFi in Quick Settings or even an active menu item with opened submenu.
    • Shadow applies to the panel menu. Use white/bright color in dark theme and black/dark color in light theme for the effect to show and help with contrast. Using same color as menu border is also a good idea. Use the Alphas for both border and shadow to increase or reduce their effect.
    • Once enabled, menu settings now also apply as soon as changed. You need to press 'Apply Menu Styles' button to enable the menu style. 'Reset Menu Styles' button will remove all menu styles and revert to your default theme.

Lastly, be a tiny bit gentler with the sliders in the settings as they modify the stylesheet behind the scene for every update.

What's New (recent first)

  • Automatic FG color, Panel Box color, Light-gradient for menus and creative tweaks for border width and radius
  • Auto-theming options
  • Import, export theme settings to file.
  • Window-Max Bar: Change Bar props when a window is maximized
  • More settings in Menus: Menu panel and buttons radius, slider tweaks
  • Apply style to notification popups
  • Candy-bar palette for panel buttons
  • Menu secondary color override to allow selecting custom (high contrast) colors within the menu
  • Fixes for screencast/ remote sharing/ battery indicators and DND toggle switch etc.
  • Rewrite to fully use stylesheet approach. Several enhancements and fixes. New additions:
    • Desktop background color palette in every color button popup. This makes it very easy to select colors according to current wallpaper.
    • Highlights with border.
    • Horizontal and vertical paddings for buttons.
    • Bar position Top vs Bottom.
    • Compatibility with Arc Menu etc.
  • New Bar Type 'Trilands' and compatibility with 'Quick Settings Audio Panel' extension
  • New overhauled version with support for menus including Calendar, Notifications, Quick Settings etc.
  • Initial version created

Screenshots

Auto-Themes Examples:

Screenshot Screenshot Screenshot

Candybar Example:

Screenshot

Window-Max Bar Example:

WindowMaxBar

More Examples: Screenshot Screenshot Screenshot Screenshot

Settings Window: Screenshot

Some More Samples:

Screenshot Screenshot Screenshot Screenshot

openbar's People

Contributors

neuromorph avatar rayzeq 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.