{"id":22543960,"url":"https://github.com/rsg-group/hyper-background","last_synced_at":"2025-04-09T23:43:31.631Z","repository":{"id":46794321,"uuid":"97387164","full_name":"RSG-Group/hyper-background","owner":"RSG-Group","description":"Easily change the background of your Hyper terminal!","archived":false,"fork":false,"pushed_at":"2024-11-29T15:48:44.000Z","size":1076,"stargazers_count":10,"open_issues_count":5,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-24T01:35:38.404Z","etag":null,"topics":["background","customizer","eslint","hyper","terminal"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/hyper-background","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RSG-Group.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-07-16T14:02:11.000Z","updated_at":"2024-11-12T22:18:35.000Z","dependencies_parsed_at":"2023-10-15T13:21:51.648Z","dependency_job_id":null,"html_url":"https://github.com/RSG-Group/hyper-background","commit_stats":{"total_commits":29,"total_committers":2,"mean_commits":14.5,"dds":0.03448275862068961,"last_synced_commit":"bfc6343f67798c613ec554ccf33aa31a756bacfe"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RSG-Group%2Fhyper-background","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RSG-Group%2Fhyper-background/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RSG-Group%2Fhyper-background/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RSG-Group%2Fhyper-background/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RSG-Group","download_url":"https://codeload.github.com/RSG-Group/hyper-background/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248131466,"owners_count":21052819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["background","customizer","eslint","hyper","terminal"],"created_at":"2024-12-07T14:05:48.608Z","updated_at":"2025-04-09T23:43:31.601Z","avatar_url":"https://github.com/RSG-Group.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hyper-background\n\n:milky_way: Change the background of your hyper terminal!\n\n[![js-standard-style](https://cdn.rawgit.com/standard/standard/master/badge.svg)](http://standardjs.com)\n\nTip: Make hyper-background the first plugin in your plugins list for optimal performance (it won't disrupt the speed of other plugins due to its performant and small size).\n\nTechnically the first plugin and the whole and sole easy way to do this :stuck_out_tongue_closed_eyes: Fun fact: We boilerplated and wrote `hyper-background` in 2 hours. And it worked the first time.\n\nNOTE: This plugin is small, which might cause it to seem unmaintained. If you see the plugin seem so, I assure you that this plugin is actively maintained and if you wish to propose a new feature, report an issue or you are submitting a PR, don't hesitate to do so. If you face issues, read the FAQ.\n\n***Supports Windows, macOS and Linux. [If you have any issues, report them at the repository's issue tracker.](https://github.com/RSG-Group/hyper-background/issues)***\n\n## Installation\n\n### Using hyper's CLI\n\nRun the following command in your Hyper terminal:\n\n```zsh\nhyper i hyper-background\n```\n\n### Manually\n\nEdit `.hyper.js` and add `\"hyper-background\"` to the `plugins` array (located near the end of your file), preferably at the start of the array, but after any theme plugins.\n\n### Using hpm-cli\n\nIf you have hpm-cli installed, run\n\n```zsh\nhpm install hyper-background\n```\n\n## FAQ\n\n**How should I specify the path?**\n\nEither you can provide an absolute path such as `/path/to/image.png` or a relative path from your home directory which hyper-background will resolve automatically.\n\n**Does this support Hyper 2 and newer versions?**\n\nYep. If you're still on Hyper 1.x or older for some reason (???), use version 1.5.1 of this plugin.\n\n## Example of a customized terminal\n\n[![Screenshot_from_2017-08-07_13-50-38.png](https://i.postimg.cc/KzkVL4LS/Screenshot-from-2017-08-07-13-50-38.png)](https://postimg.cc/1nSJ1mJJ)\n\n## Usage\n\nIn your `.hyper.js` file, which probably looks something like this at this point (note that Hyper v4+ will use JSON files for configuration instead of JS):\n\n```javascript\nmodule.exports = {\n  config: {\n    // font config\n    fontSize: 14,\n    fontFamily: 'Menlo, \"DejaVu Sans Mono\", Consolas, \"Lucida Console\", monospace',\n    // cursor config\n    cursorColor: '#EBCB8B',\n    cursorShape: 'BLOCK',\n    cursorBlink: true,\n    // color config\n    foregroundColor: '#fff',\n    backgroundColor: '#000',\n    borderColor: '#333',\n    // hyper-background can handle any value of the CSS key, whether populated manually or populated by a plugin, and will not overwrite it.\n    css: '',\n    termCSS: '',\n    // window and color config\n    showHamburgerMenu: true,\n    showWindowControls: '',\n    padding: '12px 14px',\n    colors: {\n      ...\n    },\n    // shell config\n    shell: '/bin/bash',\n    shellArgs: ['--login'],\n    env: {},\n    // behaviour config\n    bell: false,\n    copyOnSelect: false,\n  },\n  plugins: [\n    \"hyper-background\"\n  ]\n};\n```\n\nYou will need to add the path to your selected background in the `config` object as `backgroundImage` after which your `.hyper.js` should look like:\n\n```javascript\nmodule.exports = {\n  config: {\n    // font config\n    fontSize: 14,\n    fontFamily: 'Menlo, \"DejaVu Sans Mono\", Consolas, \"Lucida Console\", monospace',\n    // cursor config\n    cursorColor: '#EBCB8B',\n    cursorShape: 'BLOCK',\n    cursorBlink: true,\n    // color config\n    foregroundColor: '#fff',\n    backgroundColor: '#000',\n    borderColor: '#333',\n    // css config\n    css: '',\n    termCSS: '',\n    // window and color config\n    showHamburgerMenu: true,\n    showWindowControls: '',\n    padding: '12px 14px',\n    colors: {\n      ...\n    },\n    // shell config\n    shell: '/bin/zsh',\n    shellArgs: ['--login'],\n    env: {},\n    // behaviour config\n    bell: false,\n    copyOnSelect: false,\n\n    // Here lies our background image.\n    backgroundImage: \"/path/to/your/image\"\n  },\n  plugins: [\n    \"hyper-background\"\n  ]\n};\n```\n\nAfter this, you should have your background image ready to go!\n\n## Development\n\n***The recommended Node version required in development is Node 18+ at the time of writing. This is likely out of date when you read this, so use the latest version of Node.js available. The plugin itself works on versions as old as Node.js 6, but this is irrelevant.***\n\n- Run tests via `yarn test`\n- You can bundle the plugin via `yarn build`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsg-group%2Fhyper-background","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsg-group%2Fhyper-background","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsg-group%2Fhyper-background/lists"}