{"id":13393624,"url":"https://github.com/liamg/darktile","last_synced_at":"2025-05-15T07:06:45.415Z","repository":{"id":37623371,"uuid":"153431471","full_name":"liamg/darktile","owner":"liamg","description":":waning_crescent_moon: Darktile is a GPU rendered terminal emulator designed for tiling window managers. ","archived":false,"fork":false,"pushed_at":"2023-03-19T20:26:56.000Z","size":46887,"stargazers_count":3063,"open_issues_count":34,"forks_count":114,"subscribers_count":51,"default_branch":"main","last_synced_at":"2025-04-14T12:59:05.240Z","etag":null,"topics":["golang","opengl","terminal","terminal-emulator","terminal-emulators","vt100","xterm","xterm-256color"],"latest_commit_sha":null,"homepage":"","language":"Go","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/liamg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"liamg"}},"created_at":"2018-10-17T09:33:34.000Z","updated_at":"2025-04-13T11:09:55.000Z","dependencies_parsed_at":"2023-07-16T01:02:18.217Z","dependency_job_id":null,"html_url":"https://github.com/liamg/darktile","commit_stats":{"total_commits":23,"total_committers":4,"mean_commits":5.75,"dds":"0.17391304347826086","last_synced_commit":"159932ff3ecdc9f7d30ac026480587b84edb895b"},"previous_names":["liamg/aminal"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamg%2Fdarktile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamg%2Fdarktile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamg%2Fdarktile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamg%2Fdarktile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liamg","download_url":"https://codeload.github.com/liamg/darktile/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254292042,"owners_count":22046426,"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":["golang","opengl","terminal","terminal-emulator","terminal-emulators","vt100","xterm","xterm-256color"],"created_at":"2024-07-30T17:00:57.303Z","updated_at":"2025-05-15T07:06:40.393Z","avatar_url":"https://github.com/liamg.png","language":"Go","funding_links":["https://github.com/sponsors/liamg"],"categories":["Go","Uncategorized","Packages"],"sub_categories":["Uncategorized","Terminals"],"readme":"# Darktile\n\nDarktile is a GPU rendered terminal emulator designed for tiling window managers. \n\n![Demo](demo.gif)\n\n## Features\n\n- GPU rendering\n- Unicode support\n- Variety of themes available (or build your own!)\n- Compiled-in powerline font\n- Works with your favourite monospaced TTF/OTF fonts\n- Font ligatures (turn it off if you're not a ligature fan)\n- Hints: Context-aware overlays e.g. hex colour viewer, octal permission annotation\n- Take screenshots with a single key-binding\n- Sixels\n- Window transparency (0-100%)\n- Customisable cursor (most popular image formats supported)\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"cursor.gif\"\u003e\n\u003c/p\u003e\n\n## Installation\n\nInstall dependencies:\n\n- `xorg-dev`\n- `libgl1-mesa-dev`\n\nGrab a binary from the [latest release](https://github.com/liamg/darktile/releases/latest), `chmod +x` it and place it in your `$PATH`.\n\nIf you're too lazy to do the above and you like to live life on the edge, you can pipe this script to sudo:\n\n```bash\ncurl -s \"https://raw.githubusercontent.com/liamg/darktile/main/scripts/install.sh\" | sudo bash\n```\n\n## Configuration\n\nConfiguration files should be created in `$XDG_CONFIG_HOME/darktile/` if the variable is defined, otherwise in `$HOME/.config/darktile/`. \n\nIf you wish, you can create an example config file as a starting point using `darktile --rewrite-config`.\n\nDarktile will use sensible defaults if no config/theme files are available. The same applies when you omit settings from config/theme files, meaning it is perfectly valid to start with empty config/theme files and add to them as required to override the default behaviour.\n\n### Config File\n\nFound in the config directory (see above) inside `config.yaml`.\n\n```yaml\nopacity: 1.0       # Window opacity: 0.0 is fully transparent, 1.0 is fully opaque\nfont:\n  family: \"\"       # Font family. Find possible values for this by running 'darktile list-fonts'\n  size: 16         # Font size\n  dpi: 72          # DPI\n  ligatures: true  # Enable font ligatures e.g. render '≡' instead of '==='\ncursor:\n  image: \"\"        # Path to an image to render as your cursor (defaults to standard rectangular cursor)\n```\n\n### Example Theme\n\nFound in the config directory (see above) inside `theme.yaml`. You can replace this file with a symlink or any theme file from [darktile-themes](https://github.com/liamg/darktile-themes).\n\n\n```yaml\nblack: '#1d1f21'\nred: '#cc6666'\ngreen: '#b5bd68'\nyellow: '#f0c674'\nblue: '#81a2be'\nmagenta: '#b294bb'\ncyan: '#8abeb7'\nwhite: '#c5c8c6'\nbrightblack: '#666666'\nbrightred: '#d54e53'\nbrightgreen: '#b9ca4a'\nbrightyellow: '#e7c547'\nbrightblue: '#7aa6da'\nbrightmagenta: '#c397d8'\nbrightcyan: '#70c0b1'\nbrightwhite: '#eaeaea'\nbackground: '#1d1f21'\nforeground: '#c5c8c6'\nselectionbackground: '#aa8800'\nselectionforeground: '#ffffff'\ncursorforeground: '#1d1f21'\ncursorbackground: '#c5c8c6'\n```\n\n## Key Bindings\n\n| Action                      | Binding |\n|-----------------------------|---------|\n| Copy               | `ctrl + shift + C`\n| Paste              | `ctrl + shift + V`\n| Decrease font size | `ctrl + -`\n| Increase font size | `ctrl + =`\n| Take screenshot    | `ctrl + shift + [`\n| Open URL           | `ctrl + click`\n\n## FAQ\n\n### What happened to Aminal?\n\nThe name changed as a result of a near-complete rewrite of Aminal. Also, Google's \"did you mean animal?\" was getting pretty annoying.\n\n### Did Darktile drop Windows/OSX support?\n\nWhile the project likely won't need much work to build on Windows/OSX, the focus is to develop Darktile for tiling window managers under Linux. If you'd like to get Darktile working for other environments, pull requests are always very welcome, especially when preceded by issues/discussion.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliamg%2Fdarktile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliamg%2Fdarktile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliamg%2Fdarktile/lists"}