{"id":13640213,"url":"https://github.com/GNOME/gnome-terminal","last_synced_at":"2025-04-20T02:33:04.132Z","repository":{"id":3475419,"uuid":"4530484","full_name":"GNOME/gnome-terminal","owner":"GNOME","description":"Read-only mirror of https://gitlab.gnome.org/GNOME/gnome-terminal","archived":false,"fork":false,"pushed_at":"2024-10-21T08:43:23.000Z","size":38812,"stargazers_count":284,"open_issues_count":0,"forks_count":115,"subscribers_count":34,"default_branch":"master","last_synced_at":"2024-10-21T11:59:00.865Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gitlab.gnome.org/GNOME/gnome-terminal","language":"C++","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GNOME.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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}},"created_at":"2012-06-02T16:03:15.000Z","updated_at":"2024-10-13T16:10:07.000Z","dependencies_parsed_at":"2023-10-12T04:30:11.010Z","dependency_job_id":"9e6ac810-5159-4f77-8333-eb1e564e0ebe","html_url":"https://github.com/GNOME/gnome-terminal","commit_stats":null,"previous_names":[],"tags_count":301,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fgnome-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fgnome-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fgnome-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fgnome-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GNOME","download_url":"https://codeload.github.com/GNOME/gnome-terminal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223723525,"owners_count":17192157,"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":[],"created_at":"2024-08-02T01:01:08.924Z","updated_at":"2025-04-20T02:33:04.118Z","avatar_url":"https://github.com/GNOME.png","language":"C++","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"GNOME Terminal\n==============\n\nCI status\n---------\n\n[![pipeline status](https://gitlab.gnome.org/GNOME/gnome-terminal/badges/master/pipeline.svg)](https://gitlab.gnome.org/GNOME/gnome-terminal/-/commits/master)\n\n[![coverage report](https://gitlab.gnome.org/GNOME/gnome-terminal/badges/master/coverage.svg)](https://gitlab.gnome.org/GNOME/gnome-terminal/-/commits/master)\n\nReleases\n--------\n\n[![Latest Release](https://gitlab.gnome.org/GNOME/gnome-terminal/-/badges/release.svg)](https://gitlab.gnome.org/GNOME/gnome-terminal/-/releases)\n\nTarballs for newer releases are available from the\n[package registry](https://gitlab.gnome.org/GNOME/gnome-terminal/-/packages)\nand new and old release are also available on\n[download.gnome.org](https://download.gnome.org/sources/gnome-terminal/).\n\nSource code\n-----------\n\nTo get the source code, use\n```\n$ git clone https://gitlab.gnome.org/GNOME/gnome-terminal\n```\n\nBuilding from source\n--------------------\n\nYou will most likely need to also build `vte` from source; see https://gitlab.gnome.org/GNOME/vte/-/blob/master/README.md .\n\nStart by installing the build dependencies, and a C++ compiler.\n\nFor fedora and related distributions, use\n```\nsudo dnf build-dep vte291-gtk4 gnome-terminal\nsudo dnf install g++\n```\nwhile for debian and related distributions, use\n```\nsudo apt-get build-dep libvte-2.91-0 gnome-terminal\nsudo apt-get install g++\n```\n\nFirst build `vte` according to its own instructions. Then:\n```\n$ # Get the source code\n$ git clone https://gitlab.gnome.org/GNOME/gnome-terminal\n$\n$ # Change to the toplevel directory\n$ cd gnome-terminal\n$\n$ # Run the configure script (choose an appropriate path instead of \"/some/where\"!)\n$ # Don't forget to make sure that pkg-config can find your self-build vte!\n$ # e.g. by doing:\n$ # export PKG_CONFIG_PATH=/some/where/lib64/pkg-config:$PKG_CONFIG_PATH\n$ #\n$ # If you compiled gnome-shell into the same prefix, you can omit disabling\n$ # the search provider.\n$ #\n$ meson _build --prefix=/some/where -Dsearch_provider=false\n$\n$ # Build\n$ ninja -C _build\n$\n$ # Install\n$ ninja -C _build install\n```\n\n* By default, GNOME Terminal will install under `/usr/local`, which is not usually\nthe right choice. You can customize the prefix directory by `--prefix` option, e.g.\nif you want to install GNOME-TERMINAL under `~/foobar`, you should run\n`meson _build --prefix=$HOME/foobar`. If you already run the configure script before,\nyou should also pass `--reconfigure` option to it.\n\n* You may need to execute `ninja -C _build install` as root\n(i.e. `sudo ninja -C _build install`) if installing to system directories. Use a\nuser-writable directory as `--prefix` instead to avoid that.\n\n* Since GNOME Terminal uses a D-Bus activated server, you cannot simply run\nthe self-built gnome-terminal directly. Instead, you need to start the new `gnome-terminal-server` directly using\n```\n$ ./_build/src/gnome-terminal-server --app-id test.Terminal \u0026\n```\nand then you have 10s time to open a window in that server using\n```\n$ ./_build/src/gnome-terminal --app-id test.Terminal\n```\n\nAlso see https://wiki.gnome.org/Apps/Terminal/Debugging for more information.\n\nDebugging\n---------\n\nAfter installing GNOME-TERMINAL with `-Ddbg=true` flag, you can use `GNOME_TERMINAL_DEBUG` variable to control\nGNOME-TERMINAL to print out the debug information\n\n```\n$ GNOME_TERMINAL_DEBUG=selection ./_build/src/gnome-terminal-server [...]\n\n# Or, you can mixup with multiple logging level\n$ GNOME_TERMINAL_DEBUG=selection,draw,cell ./_build/src/gnome-terminal-server [...]\n\n$ Or, you can use `all` to print out all logging message\n$ GNOME_TERMINAL_DEBUG=all ./_build/src/gnome-terminal-server [...]\n```\n\nFor logging level information, please refer to enum [TerminalDebugFlags](src/terminal-debug.hh).\n\nContributing\n------------\n\nBugs should be filed here: https://gitlab.gnome.org/GNOME/gnome-terminal/issues/\nPlease note that this is a bug tracker to be used for developers of GNOME Terminal,\nand contributors of code, documentation, and translations to GNOME Terminal,\nand *not a support forum*.\n\nIf you are an end user, always file bugs in your distribution's bug tracker, or use their\nsupport forums.\n\nIf you want to provide a patch, please attach them to an issue in GNOME\nGitLab, in the format output by the `git format-patch` command.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGNOME%2Fgnome-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGNOME%2Fgnome-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGNOME%2Fgnome-terminal/lists"}