varemenos/atom-toolbar-almighty

Toolbar Almighty - the only toolbar you need

This is a toolbar that provides many commonly used actions utilizing the tool-bar API.

Toolbar entries

Available toolbar buttons:

new file
open file
open folder
save file
open git-control (missing from the screenshot) (requires git-control package)
open git projects (requires git-projects package)
list projects (requires project-manager package)
split screen horizontally
split screen vertically
git merge conflicts (requires merge-conflicts package)
toggle fullscreen
toggle tree-view
toggle minimap (requires minimap package)
auto indent
fold all
unfold all
reload window
toggle devtools
settings

Note: The toolbar buttons that require other packages will only appear if you have those packages installed

Installation

First you have to install the tool-bar package which is required:

apm install tool-bar

Then you install the tool-bar-almighty package:

apm install tool-bar-almighty

Options

You have the ability to include custom entries.
You also have the ability to load the suggested defaults along side your custom entries, or only the custom entries.

Custom entries

You have the ability to include custom entries in the tool-bar-almighty by enabling the option in the package settings and entering a path relative to your .atom directory (that contains the entries you want to add).

The file must be in JSON format that contains an Array of entries.

Format

The format is based on tool-bar's but include 2 extra properties.

type indicates whether the entry is a button or a spacer
dependency indicates whether a button's package is not installed by default in Atom and should only be displayed if it's package is installed.

Example

Create a file inside .atom's directory, in this case ~/.atom/custom_entries.json
The tool-bar-almighty setting's value must match the filename mentioned above custom_entries.json (relative to the .atom directory)
The content of the file should look like the following:

[
  {
    "type": "button",
    "tooltip": "Open File",
    "callback": "application:open-file",
    "icon": "document-text",
    "iconset": "ion"
  },
  {
    "type": "spacer"
  },
  {
    "type": "button",
    "tooltip": "Open Folder",
    "callback": "application:open-folder",
    "icon": "folder",
    "iconset": "ion"
  },
  {
    "type": "button",
    "tooltip": "Merge Conflicts",
    "dependency": "merge-conflicts",
    "callback": "merge-conflicts:detect",
    "icon": "code-fork",
    "iconset": "fa"
  }
]

Known Issues / FAQ

We've decided to remove the term2/term3 entries from the default entries, for more details and a possible fix read this issue's thread.
We've decided to only support the JSON format for the custom entries to prevent future formating issues.

License

The MIT License

varemenos / atom-toolbar-almighty