zsh-magic-dashboard

Pressing enter on an empty buffer displays an information-rich and pretty dashboard.

<!-- LTeX: enabled=true -->

• Top: Recent commits (git log)
  
• Center: Current Status (hybrid of git status and git diff --stat)
  
• Bottom: Files in the current directory (via eza)

Empty components, such as git status in a clean repo, are automatically hidden.

Table of contents

• Installation
  • Requirements
  • Manual
  • Package managers
    • oh-my-zsh
• Configuration
• Usage
• Display dashboard on cd
• Credits

Installation

Requirements

• eza
• Nerdfont

Manual

Clone this repository somewhere on your machine. This manual assumes you are using ~/.zsh/.

bash cd ~/.zsh # where to install the plugin git clone https://github.com/chrisgrieser/zsh-magic-dashboard

Add the following to your ~/.zshrc:

bash source ~/.zsh/zsh-magic-dashboard/magic_dashboard.zsh

Package managers

I don't use a package manager, since they are mostly unnecessary and even increasing zsh loading time considerably.

Thus, this section only includes installation instructions from people who made a PR adding them.

oh-my-zsh

Clone this repository into $ZSH_CUSTOM/plugins (by default ~/.oh-my-zsh/custom/plugins)

bash git clone https://github.com/chrisgrieser/zsh-magic-dashboard ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-magic-dashboard

Add the plugin to the list of plugins for oh-my-zsh to load (inside ~/.zshrc):

bash plugins=( # other plugins... zsh-magic-dashboard )

Start a new terminal session.

bash source ~/.zshrc

Configuration

Export these variables in your ~/.zshrc. The values displayed are the defaults.

```bash export MAGICDASHBOARDGITLOGLINES=5 export MAGICDASHBOARDFILESLINES=6 export MAGICDASHBOARDFILES_LINES=4

export MAGICDASHBOARDDISABLEDBELOWTERM_HEIGHT=15 ```

Usage

Just press enter on an empty buffer. That's it!

Display dashboard on cd

The dashboard call also be called via _magic_dashboard. One use case would be to modify your cd command to display the dashboard after the directory change.

bash function cd { builtin cd "$@" && _magic_dashboard }

Credits

This plugin is based on Magic Enter by @dufferzafar.

In my day job, I am a sociologist studying the social mechanisms underlying the digital economy. For my PhD project, I investigate the governance of the app economy and how software ecosystems manage the tension between innovation and compatibility. If you are interested in this subject, feel free to get in touch.

• Website
• ResearchGate
• Discord
• LinkedIn