Open Source Extras Gitify Installation


As of Gitify v2 and up, installation has been simplified and is handled entirely via composer. You can choose to install Gitifiy globally, or locally to a project.

For a global installation, run:

composer global require modmore/gitify:^2

After the installation completes, you’ll use gitify as the main command.

For a local project installation, run:

composer require modmore/gitify:^2

After the installation completes, you’ll use vendor/bin/gitify as the main command.

Finally, for development or advanced usage, you may continue to use the manual installation steps:

git clone Gitify
cd Gitify
composer install --no-dev
chmod +x bin/gitify

In this case you’ll use bin/gitify as the main command.

Note that the gitify executable has been moved into the bin directory on v2. You may need to adjust your $PATH accordingly.

v1 (and prior)

New as of v0.2 is that dependencies are managed via Composer, most notably it has been rebuilt on top of Symfony’s Console component to provide a more feature-packed base to build from. Follow these instructions if you haven’t installed Composer before

To get started with Gitify, it’s easiest to set up a local clone of this repository. It doesn’t matter in which folder clone it to. On Unix/Linux systems you can choose your home directory. After that, run Composer to download the dependencies, and finally make the Gitify file executable to run it.

git clone Gitify
cd Gitify
# If you haven't installed composer, yet, you can do this to install the composer.phar:
# curl -sS | php
composer install --no-dev 
# or: php composer.phar install --no-dev
chmod +x Gitify

At this point you should be able to type ./Gitify and get a response like the following:

Gitify version 0.2.0

  [options] command [arguments]

  --help           -h Display this help message.
  --verbose        -v|vv|vvv Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
  --version        -V Display the Gitify version.

Available commands:
  build          Builds a MODX site from the files and configuration.
  extract        Extracts data from the MODX site, and stores it in human readable files for editing and committing to a VCS.
  help           Displays help for a command
  init           Generates the .gitify file to set up a new Gitify project. Optionally installs MODX as well.
  list           Lists commands
  install:modx   Downloads, configures and installs a fresh MODX installation.

If that’s working as expected, the next step is to add the Gitify executable to your PATH so you can run Gitify in any directory. Edit your ~/.bash_profile, ~/.zshrc or ~/.profile file and add the following, with the right path to the Gitify directory (not the executable file):

export PATH=/path/to/Gitify/:$PATH

Restart your terminal and you should be good to go.

For successfull installing of MODX by Gitify install:modx command you should have installed unzip command in your system. For Debian/Ubuntu you can use sudo apt-get install unzip.