Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sindrets/atom-title-bar-replacer

Adds an alternative, theme-aware title bar and application menu that is more inline with Atom's UI design.
https://github.com/sindrets/atom-title-bar-replacer

Last synced: 24 days ago
JSON representation

Adds an alternative, theme-aware title bar and application menu that is more inline with Atom's UI design.

Awesome Lists containing this project

README

        

# Title Bar Replacer

[![apm](https://flat.badgen.net/apm/license/title-bar-replacer)](https://atom.io/packages/title-bar-replacer)
[![apm](https://flat.badgen.net/apm/v/title-bar-replacer)](https://atom.io/packages/title-bar-replacer)
[![apm](https://flat.badgen.net/apm/dl/title-bar-replacer)](https://atom.io/packages/title-bar-replacer)

Adds an alternative, theme-aware title bar and application menu that is more
inline with Atom's UI design.

![Showcase of the replacer](http://i.imgur.com/s4wUu5M.gif)

This package is aimed mostly at Windows users, as the native Windows title bar
doesn't really go well with Atom's UI design. This title bar replacer adds a
functional custom title bar, that lets you move, scale, and utilize Aero-snap
features. It also adds a custom application menu that is somewhat more
intelligent in terms of design. The default behaviour of the title bar and
application menu is to choose colors based on the theme you are currently
using. However, most of the colors can be customized in the settings, and the
menu can also be hidden.

## Installation

Install through Atom's [install view](atom://settings-view/show-package?package=title-bar-replacer) or use apm:

```sh
$ apm install title-bar-replacer
```

## Removing the Native Title Bar

As of Atom version 1.53.0 you no longer need to patch Atom in order to hide the
native title bar! Go to Settings > Core > Title bar, and set it to `hidden`.
Restart Atom and enjoy the custom title bar.

## Keyboard Navigation

The menu bar can be fully utilized from the keyboard. Pressing Alt
will allow you to access the various categories through alt key shortcuts, or
arrow keys.

- Alt - toggle alt key shortcuts or close menu if it's open
- - navigate the menu
- Enter - Use selected menu item
- Space - Use selected menu item without closing the application menu
- Esc - Close menu
- Alt+Shift+M - Toggle menu bar visibility
- Ctrl+Alt+Shift+M - Toggle title bar visibility

![Keyboard Navigation](http://i.imgur.com/WeAerzg.gif)

## UI Customization

There are provided settings to adjust the title bar layout style as well as a
few different window contols presets. If there is some design you are unhappy
with, or some design features you miss, the title bar is highly adjustable
through CSS (Atom's stylesheet).

![UI Customization](https://i.imgur.com/XkEmfzB.gif)

## Changelog

### 2.0.0 - Complete rewrite

- The plugin has been rewritten completely from scratch
- More than 4x faster
- Reworked keyboard navigation
- Efficient menu diff and updates
- Setting for alt focus
- Setting for menu mnemonics
- Title text is hidden when it intersects with the menu bar.
- Dock toggle buttons are now accessible without a window frame.
- Removed the window frame remover in favor of the new 'Title Bar > hidden' setting.
- Less terrible code

### 1.8.1

- Fixed fatal bug occurring when no serialization state exists.

### 1.8.0 - Performance Optimization

- Unimplemented the transpiler. All TypeScript source files are now compiled pre-distribution.
- Implemented serialization. HTML is now stored and deserialized upon launch.
- Fixed bug that caused the 'Restore Defaults' button not to work.
- Handling exiting and disabling properly
- More type definitions.

[Full changelog](https://github.com/sindrets/atom-title-bar-replacer/blob/master/CHANGELOG.md)

## License

This work is licensed under the [GNU General Public License v3.0 only](LICENSE)