PHPackages                             koppieesq/propellerhat - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. koppieesq/propellerhat

ActiveLibrary

koppieesq/propellerhat
======================

For your inner child - the nerdy one who has a little cap with a propeller on the top.

10PHPCI failing

Since Jan 8Pushed 6y agoCompare

[ Source](https://github.com/koppieesq/propellerhat)[ Packagist](https://packagist.org/packages/koppieesq/propellerhat)[ RSS](/packages/koppieesq-propellerhat/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (4)Used By (0)

propellerhat
============

[](#propellerhat)

[![github](https://camo.githubusercontent.com/a59078159f1b3259705c40541692d765183ccb8b0b02b9df04796a512f7cb45c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6769746875622d3061302e7376673f6c6f676f3d676974687562)](https://github.com/koppieesq/propellerhat)[![packagist](https://camo.githubusercontent.com/18424c7320933ee388f0c078fecdab540d8b0cfb701d4e195d03e7634ea78bda/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b61676973742d6f72616e67652e7376673f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/koppieesq/propellerhat)[![License](https://camo.githubusercontent.com/8d25c6b3e959e543b0a5ce0283d029c8087bba82005b49c94ba22526ab261dc4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c332d7465616c2e7376673f6c6f676f3d676e75)](LICENSE)

For your inner child - the nerdy one who has a little cap with a propeller on the top.

Some of these are bash scripts, but most use [Robo](https://robo.li).

Contents:
---------

[](#contents)

- **.bash\_profile:** Custom settings for your command line interface
- **.bash\_logout:** Cute script that runs when you end a terminal session.
- **.vimrc:** Custom settings for the VI text editor
- **new\_ticket:** Refresh your local dev environment when you start a new task

    - *usage:* `robo new_ticket`
    - *shortcut:* `robo nt`
- **updateme:** Update contrib code on all your Drupal sites at once.

    - *usage:* `robo updateme`
- **new\_environment:** Install all your favorite tools. See below for instructions.
- **Obsolete tools:** These are some nifty tools that I wrote, but they've been supplanted by much better, open source tools written by other people.

    - **db down:** Sync database from a [Pantheon](https://pantheon.io) site.
        - *You should probably use [Terminus](https://github.com/pantheon-systems/terminus) instead.*
    - **upload key:** Uploads your SSH key.
        - *You should probably use `ssh-copy-id` instead.*

New Environment
---------------

[](#new-environment)

### Installation Instructions

[](#installation-instructions)

The new\_environment() function installs all your favorite tools when you have a new local environment (for example, when you get a new workstation). However, it presents the classic 'chicken &amp; egg' problem: how are you supposed to install anything without your dev tools?

Fortunately it's easy:

1. Install xcode command line tools. This gets you git. ;-)

```
xcode-select --install
```

1. Use git to clone propellerhat to your local environment
2. Install [Robo](https://robo.li/)
3. Run the new\_environment installer and specify environment. Currently only supports Mac:

```
robo new_environment mac
```

Communication Tools
-------------------

[](#communication-tools)

- **Google Chrome:** Web browser from Google.
- **Firefox:** Web browser from Mozilla Foundation.
- **Slack:** Instant messenger program popular with tech companies.
- **Skype:** Instant messenger program from Microsoft.

### Command Line Tools

[](#command-line-tools)

- **Hub:** Command line tool for GitHub. Lets you submit pull requests.
- **ssh-copy-id:** Copy your public ssh key to a new server.
- **bar:** Add a progress bar to long tasks, like database import.
- **bat:** `cat` command on steroids.
- **htop:** `top` command on steroids.
- **Glances:** `top` command on steroids.
- **exa:** `ls` command on steroids.
- **z:** Improves behavior of ls with autocomplete.

### Mac OS X Tools

[](#mac-os-x-tools)

- **1 Clipboard:** Clipboard memory tool
- **Bearded Spice:** Use your Mac function keys to control any music player.
- **Spectacle:** Control window layout with hotkeys.
- **Synergy:** Control multiple computers with a single keyboard &amp; mouse. Cross-platform.

### Development Tools

[](#development-tools)

- **Ansible:** Used to manage virtual servers.
- **Composer:** Package manager for PHP.
- **Docker:** Platform for virtual servers.
- **Chromedriver:** Control Google Chrome with Selenium Webdriver.
- **Lando:** Tool for managing local development environments.
- **Livereload:** Daemon watches a local folder for changes, then reloads your web browser.
- **PHPStorm:** Integrated Development Environment. Non-free product.
- **Virtualbox:** Platform for virtual servers.
- **Source Code Pro:** Beautiful fixed-width font, perfect for your IDE.

### Fun Tools

[](#fun-tools)

- **Cowsay:** Wraps your command line output in a word bubble, spoken by a cow.
- **Figlet:** Renders command line output as big, puffy letters.
- **Fortune:** Tells you your fortune.
- **Lolcat:** Output command line text in rainbow colors.
- **Spotify:** Play any song legally, for free.
- **VLC:** 3rd party video player supports any video format.
- **Edex-UI:** Make your computer look like a movie hacker. Includes fully functional CLI.

### Support Libraries

[](#support-libraries)

The following are libraries, installed as prerequisites for other tools on the list: glib, node, nvm, php@7.1, java

Configuration
-------------

[](#configuration)

You can control how certain scripts behave. Copy `default.robo.yml` and save it as `robo.yml` in the same directory. You can also store `robo.yml` in your home directory (`~`).

### Configuring new\_ticket

[](#configuring-new_ticket)

The following variables can be easily changed in the config file:

- **upstream\_repo:** Name of the upstream repository in git
- **fork\_repo:** Name of your forked version of the repository
- **base\_branch:** The master branch. Usually `master` (but not always)
- **guest\_path:** The path to your codebase inside the VM
- **runner:** Use this to run task runners like composer or npm. Runs outside the VM.
- **vm\_start:** Command to start &amp; reprovision the VM
- **vm\_ssh:** How to send commands from the host to the VM
- **commands:** List of commands to be run inside the VM. Default examples:
    - `blt setup -n`: Uses the Acquia blt utility to set up local env
    - `drush cim -y`: Import Drupal config
    - `drush updb -y`: Run database updates
    - `drush cr`: Reset cache
    - `drush uli`: Log in and provide a link that's viewable from the host OS

Roadmap
=======

[](#roadmap)

The following new features are contemplated for the future:

- Add additional items to new\_environment():
    - Alias for Robo commands
    - Add optional toys: steam, bitlord, wesnoth, minecraft

Credits
=======

[](#credits)

Brought to you by [Jordan Koplowicz](http://koplowiczandsons.com). This software is free to use, modify, and distribute under the GPL 3 license.

With gratitude to [Greg Andersen](https://github.com/g1a/starter) and [Ben Thronton](https://git.businesswire.com/projects/HQ/repos/hq-tools/browse/dev/reset-dev).

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/38f114c40be6540cfe965f0c15a175cc5a72e5b4e8942f4801d27dee140d7d4c?d=identicon)[koppie](/maintainers/koppie)

---

Top Contributors

[![koppieesq](https://avatars.githubusercontent.com/u/5446321?v=4)](https://github.com/koppieesq "koppieesq (5 commits)")

### Embed Badge

![Health badge](/badges/koppieesq-propellerhat/health.svg)

```
[![Health](https://phpackages.com/badges/koppieesq-propellerhat/health.svg)](https://phpackages.com/packages/koppieesq-propellerhat)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
