Skip to content

Instantly share code, notes, and snippets.

@silverjerk
Last active May 28, 2025 18:15
Show Gist options
  • Save silverjerk/c6709df5a21f7a7fa6880334adda1883 to your computer and use it in GitHub Desktop.
Save silverjerk/c6709df5a21f7a7fa6880334adda1883 to your computer and use it in GitHub Desktop.
Hyper Config File
// Future versions of Hyper may add additional config options,
// which will not automatically be merged into this file.
// See https://hyper.is#cfg for all currently supported options.
module.exports = {
config: {
// Choose either "stable" for receiving highly polished,
// or "canary" for less polished but more frequent updates
updateChannel: 'stable',
// default font size in pixels for all tabs
fontSize: 14,
// font family with optional fallbacks
fontFamily: 'Monaco, Consolas, "Lucida Console", monospace',
// terminal cursor background color and opacity (hex, rgb, hsl, hsv, hwb or cmyk)
cursorColor: 'rgba(248,28,229,0.8)',
// `BEAM` for |, `UNDERLINE` for _, `BLOCK` for █
cursorShape: 'BLOCK',
// set to true for blinking cursor
cursorBlink: false,
// color of the text
foregroundColor: '#fff',
// terminal background color
backgroundColor: '#000',
// border color (window, tabs)
borderColor: '#333',
// custom css to embed in the main window
css: `
.tab_tab {
background-color: #1f2329 !important;
}
.tab_tab.tab_active {
background-color: #282c34 !important;
}
`,
// custom css to embed in the terminal window
termCSS: '',
// set to `true` (without backticks) if you're using a Linux setup that doesn't show native menus
// default: `false` on Linux, `true` on Windows (ignored on macOS)
showHamburgerMenu: 'false',
// set to `false` if you want to hide the minimize, maximize and close buttons
// additionally, set to `'left'` if you want them on the left, like in Ubuntu
// default: `true` on windows and Linux (ignored on macOS)
showWindowControls: 'false',
// custom padding (css format, i.e.: `top right bottom left`)
padding: '12px 14px',
// the full list. if you're going to provide the full color palette,
// including the 6 x 6 color cubes and the grayscale map, just provide
// an array here instead of a color map object
colors: {
black: '#000000',
red: '#ff0000',
green: '#33ff00',
yellow: '#ffff00',
blue: '#0066ff',
magenta: '#cc00ff',
cyan: '#00ffff',
white: '#d0d0d0',
lightBlack: '#808080',
lightRed: '#ff0000',
lightGreen: '#33ff00',
lightYellow: '#ffff00',
lightBlue: '#0066ff',
lightMagenta: '#cc00ff',
lightCyan: '#00ffff',
lightWhite: '#ffffff'
},
// the shell to run when spawning a new session (i.e. /usr/local/bin/fish)
// if left empty, your system's login shell will be used by default
//
// Windows
// - Make sure to use a full path if the binary name doesn't work
// - Remove `--login` in shellArgs
//
// Bash on Windows
// - Example: `C:\\Windows\\System32\\bash.exe`
//
// Powershell on Windows
// - Example: `C:\\WINDOWS\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`
shell: '/bin/zsh',
// for setting shell arguments (i.e. for using interactive shellArgs: ['-i'])
// by default ['--login'] will be used
shellArgs: ['--login'],
// for environment variables
env: {},
// set to false for no bell
bell: 'SOUND',
// if true, selected text will automatically be copied to the clipboard
copyOnSelect: false,
// if true, on right click selected text will be copied or pasted if no
// selection is present (true by default on Windows)
// quickEdit: true
// URL to custom bell
// bellSoundURL: 'http://example.com/bell.mp3',
// for advanced config flags please refer to https://hyper.is/#cfg
summon: {
hotkey: 'Cmd+`'
},
hypercwd: {
initialWorkingDirectory: '~/Development/Sites'
},
hyperStatusLine: {
dirtyColor: 'salmon',
aheadColor: 'ivory',
footerTransparent: true
},
hyperTabs: {
trafficButtons: true,
border: false,
tabIconsColored: true,
closeAlign: 'right',
}
},
// a list of plugins to fetch and install from npm
// format: [@org/]project[#version]
// examples:
// `hyperpower`
// `@company/project`
// `project#1.0.1`
plugins: [
"hyper-tabs-enhanced",
"hyperterm-atom-dark",
"hypercwd",
"hyperterm-paste",
"hyper-statusline",
"hyperterm-summon",
],
// in development, you can create a directory under
// `~/.hyper_plugins/local/` and include it here
// to load it and avoid it being `npm install`ed
localPlugins: [],
keymaps: {
// Example
// 'window:devtools': 'cmd+alt+o',
}
};
@JEdwardnarvaez
Copy link

Man I just copied and pasted this code into my hyper preferences cause I thought I was going to somehow 'reset it' now I doesn't even run, I got hours trying to solve this with no success. I don't know what to do now.

@OrangeVenom563
Copy link

same problem it doesnt work

@OrangeVenom563
Copy link

The js file exists in Appdata\Roaming\Hyper
paste the config js file here

@helloromero
Copy link

Adding this file to the below dir on mac made hyper commands work again.

~/Library/Application Support/Hyper/.hyper.js

@Davidmichael-ux
Copy link

why hyper tells me that there is error in js

@silverjerk
Copy link
Author

why hyper tells me that there is error in js

I haven't run Hyper in years, so I'm not sure I could offer any help. This was my personal config file before moving to managing all my emulator settings via dotfiles; and I've since moved on to Ghostty (after a long stint with iTerm2, again).

The only issue I can see in the file is the empty string values for the hamburger menu settings.

It's likely Hyper may have changed how it formats its config files, as there's no syntax errors in the gist's JS.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment