{"id":21198432,"url":"https://github.com/icebreaker/marmota","last_synced_at":"2025-10-03T20:12:47.924Z","repository":{"id":136586286,"uuid":"268162372","full_name":"icebreaker/marmota","owner":"icebreaker","description":"marmota is an opinionated and minimalist terminal emulator based on VTE.","archived":false,"fork":false,"pushed_at":"2024-09-27T15:29:09.000Z","size":1716,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-11T04:44:19.761Z","etag":null,"topics":["gtk3","libvte","linux","linux-terminal","terminal","terminal-emulator","vte"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/icebreaker.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-05-30T21:27:22.000Z","updated_at":"2024-09-27T16:40:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"f6af2954-9b7e-4c3e-ba25-4aee7fef246f","html_url":"https://github.com/icebreaker/marmota","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/icebreaker/marmota","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icebreaker%2Fmarmota","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icebreaker%2Fmarmota/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icebreaker%2Fmarmota/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icebreaker%2Fmarmota/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/icebreaker","download_url":"https://codeload.github.com/icebreaker/marmota/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icebreaker%2Fmarmota/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278219800,"owners_count":25950355,"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","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["gtk3","libvte","linux","linux-terminal","terminal","terminal-emulator","vte"],"created_at":"2024-11-20T19:51:28.821Z","updated_at":"2025-10-03T20:12:47.870Z","avatar_url":"https://github.com/icebreaker.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"marmota\n=======\nmarmota is an _opinionated_ and _minimalist_ terminal emulator based on [VTE][1].\n\n![marmota logo by T. Michael Keesey](res/marmota.png)\n\n![demo screenshot](res/demo.png)\n\nGetting Started\n---------------\nThere are no precompiled binaries, therefore you'll have to compile marmota yourself.\n\nThis isn't terribly difficult, since there are only a handful of dependencies,\nnamely: [GTK+ 3.0+][2] and [VTE 0.91+][1].\n\nOnce you installed the _development_ versions (with headers) of these dependencies,\nit becomes possible to compile marmota by typing `make` in a terminal.\n\n```bash\n$ make\n```\n\nThis will result in a `build/config.h` configuration header file and a `build/marmota` executable.\n\nThe `build/config.h` header file contains the default compile time configuration.\n\nIn most cases, you will want to modify `buld/config.h` and then recompile marmota\nby typing `make` again in a terminal.\n\n```bash\n$ vim build/config.h\n...\n\u003cedit configuration\u003e\n...\n$ make\n```\n\nOnce marmota has been compiled, it can be _installed_ in `/usr/local` or\nanother prefix of your choice by typing `make install` in a terminal.\n\n```bash\n$ make install\n\nor\n\n$ make install PREFIX=/opt\n```\n\nBy default, marmota allows you to customize _the first 16_ colors via the\n`.colors` array in `build/config.h`.\n\nIf more colors are desired or needed, then marmota needs to be compiled as such.\n\n```bash\n$ make MAX_COLORS=24\n```\n\nIn the example above, we reserved 24 colors instead of 16.\n\nAny color entries, not specified in `build/config.h`, will default to reasonable\nhard-coded values.\n\n### Command Line Arguments\nWhen no command line arguments are given, marmota will attempt to detect the current\nuser's preferred SHELL or fallback to `/bin/sh`.\n\nWhether or not this is a _login shell_ is determined by the `.login_shell`\n(defaults to `true`) option in `build/config.h`.\n\nTo execute another command, instead of the SHELL, the `-e` command\nline argument can be used.\n\n```bash\n$ marmota -e tmux\n```\n\nor\n\n```bash\n$ marmota -e /bin/sh -l -c tmux\n```\n\nAny arguments after `-e` are considered to be part of the command to execute.\n\nIn addition to `-e`, there's an additional argument, called `-hold` that can be\nleveraged to prevent marmota from closing after the SHELL or the given command has\nexited.\n\nThis can be useful, when using marmota as a _terminal_ from within some IDE, and\nit's desirable to see the output after the SHELL or the the given command has\nexited.\n\n```bash\n$ marmota -hold -e ls -lah\n```\n\nIf the `.allow_hold_escape_shortcut` configuration option has been set to `true`\n(default to `true`), then it is possible to close marmota by pressing escape\nafter the given command has exited in `-hold` mode.\n\nContribute\n----------\n* Fork the project.\n* Make your feature addition or bug fix.\n* Do **not** bump the version number.\n* Create a pull request. Bonus points for topic branches.\n\nLicense\n-------\n**marmota** is provided **as-is** under the **MIT** license.\nFor more information see LICENSE.\n\n[Marmota monax (Linnaeus, 1758)][3] logo by T. Michael Keesey is licensed under CC0 1.0.\n\n[1]: https://gitlab.gnome.org/GNOME/vte\n[2]: https://www.gtk.org/\n[3]: http://phylopic.org/image/eee50efb-40dc-47d0-b2cb-52a14a5e0e51/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficebreaker%2Fmarmota","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficebreaker%2Fmarmota","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficebreaker%2Fmarmota/lists"}