Have ideas to improve npm?Join in the discussion! »

    hyper-hypest

    1.3.0 • Public • Published

    Hypest Icon

    Hypest for Hyper

    A beautiful and minimal macOS theme for Hyper — with vibrancy, light and dark modes, and theming for several popular Hyper plugins.

    Hypest Screenshot

    Installation

    If you are switching from another Hyper theme you may need to relaunch the app for Hypest to fully theme the window.

    From Hyper

    hyper i hyper-hypest

    Manually

    1. Open ~/.hyper.js in your text editor (cmd + , in Hyper)
    2. Add hyper-hypest to the plugins array

    Configuration

    There are a few options that can be passed as optional configuration to modify the theme. To pass the options you can add a hypest object to the config in ~/.hyper.js.

    Note: you may need to restart Hyper when setting or switching between the values for the darkmode, vibrancy and hideControls properties.

    Dark Mode

    Set darkmode to true to use the dark version of the theme.

    config: {
        ...
        hypest: {
            // Default is false
            darkmode: true
        }
        ...
    }

    Hypest Screenshot

    Vibrancy

    Set vibrancy to false to disable the window vibrancy effect in either theme.

    config: {
        ...
        hypest: {
            // Default is true
            vibrancy: false,
        }
        ...
    }

    Hypest Screenshot

    Vibrancy level

    To have the window appear more transparent when vibrancy is enabled, set vibrancyLevel to a value between 0 and 0.5. To have the window appear more opaque, increase vibrancyLevel to a value between 0.7 and 1.0.

    For both light and dark versions, the default vibrancy level is 0.6.

    config: {
        ...
        hypest: {
            // Default value is 0.6
            vibrancyLevel: 0.6
        }
        ...
    }

    Borders

    Set borders to true if you prefer your tabs with some more contrast.

    config: {
        ...
        hypest: {
            // Default is false
            borders: true
        }
        ...
    }

    Hypest Screenshot

    Remove window controls

    Set hideControls to true to remove the window controls and just show tabs.

    config: {
        ...
        hypest: {
            // Default is false
            hideControls: true
        }
        ...
    }

    Hypest Screenshot

    Accent color

    Pass a supported named color with accentColor to use it for the cursor color, selection color and the search styling (if using the hyper-search plugin). It's also used for activity in hyper-tabs-enhanced and hyper-statusline.

    config: {
        ...
        hypest: {
            // Default is 'blue'
            // Use one of 'black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan' or 'white'
            accentColor: 'cyan'
        }
        ...
    }

    Custom theme colors

    Hypest has it's own set of colors defined by the theme but you can override them by adding a colors object and setting all or some of the supported color properties. These custom colors will also be inherited by accentColor.

    config: {
        ...
        hypest: {
            // Supported  colors are 'black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan' and 'white'
            // Custom colors must be specified as 6 character hexadecimals
            colors: {
              blue: '#0067FF'
            }
        }
        ...
    }

    Plugin support

    Hypest includes custom theming to support a few of the most popular Hyper plugins, including:

    • hyper-search
    • hyper-statusline
    • hyper-tab-icons
    • hyper-highlight-active-pane
    • hyper-tabs-enhanced

    Hypest Screenshot

    Known issues

    Issues with selection colors when vibrancy is enabled

    There is a known issue in the Xterm.js engine where selection colors appear to render as opaque blocks with invisible text if the background has transparency. There is a known issue on the Hyper repository and an open issue on the Xterm.js repo but unfortunately no fixes for the issue as it stands.

    If you're just looking to solve pasted text selection for zsh shells there is a workaround for that at least, left in a comment on the Hyper issue. Run the following command to disable the background color of pasted content to make pasted text visible:

    echo 'unset zle_bracketed_paste' >> ~/.zshrc
    

    The only way to entirely work around the issue for now is to use the non-vibrant theme in Hypest by setting vibrancy to false in your Hypest configuration.

    Install

    npm i hyper-hypest

    DownloadsWeekly Downloads

    196

    Version

    1.3.0

    License

    MIT

    Unpacked Size

    28.5 kB

    Total Files

    4

    Last publish

    Collaborators

    • avatar