{"id":22083226,"url":"https://github.com/calebdw/teams-for-linux-custom-bg","last_synced_at":"2026-01-04T20:47:04.750Z","repository":{"id":223338877,"uuid":"760049863","full_name":"calebdw/teams-for-linux-custom-bg","owner":"calebdw","description":"Custom backgrounds for the `teams-for-linux` client","archived":false,"fork":false,"pushed_at":"2024-09-17T16:13:23.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-29T04:44:05.072Z","etag":null,"topics":["custom-background","teams-for-linux"],"latest_commit_sha":null,"homepage":"","language":"Makefile","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/calebdw.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"calebdw"}},"created_at":"2024-02-19T17:30:56.000Z","updated_at":"2024-12-27T10:43:36.000Z","dependencies_parsed_at":"2024-02-19T19:19:39.005Z","dependency_job_id":"0c2dda57-47f2-490e-a9f6-7753d754b501","html_url":"https://github.com/calebdw/teams-for-linux-custom-bg","commit_stats":null,"previous_names":["calebdw/teams-for-linux-custom-bg"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calebdw%2Fteams-for-linux-custom-bg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calebdw%2Fteams-for-linux-custom-bg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calebdw%2Fteams-for-linux-custom-bg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calebdw%2Fteams-for-linux-custom-bg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/calebdw","download_url":"https://codeload.github.com/calebdw/teams-for-linux-custom-bg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245170430,"owners_count":20572065,"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":["custom-background","teams-for-linux"],"created_at":"2024-12-01T00:12:05.097Z","updated_at":"2026-01-04T20:47:04.722Z","avatar_url":"https://github.com/calebdw.png","language":"Makefile","funding_links":["https://github.com/sponsors/calebdw"],"categories":[],"sub_categories":[],"readme":"# teams-for-linux custom backgrounds\n\nThis servers custom images for the [teams-for-linux](https://github.com/IsmaelMartinez/teams-for-linux/tree/develop) client using Docker (or Podman) and Nginx.\n\n## Installation\n\nSee the [docs](https://github.com/IsmaelMartinez/teams-for-linux/tree/develop/app/config#custom-backgrounds) for reference.\n\n### Adding Backgrounds\n\nFirst add your custom backgrounds to the `backgrounds` directory, you will also need a separate thumbnail for each background.\nThen copy the example config file to `config.json`:\n\n```bash\ncp backgrounds/config.json.v2.example backgrounds/config.json\n```\n\nAnd update the `config.json` file with the correct paths for the backgrounds and thumbnails.\nRefer to the [docs](https://github.com/IsmaelMartinez/teams-for-linux/tree/develop/app/config#configuring-list-of-images) for more information.\n\n### Setup SSL Certificates\n\n[mkcert](https://github.com/FiloSottile/mkcert) is used to setup SSL certs for local development.\n\nTo use, execute the following commands:\n\n```bash\nsudo apt install mkcert libnss3-tools\nmkcert -install\nmkcert -cert-file ./certs/local.crt -key-file ./certs/local.key \"teams-backgrounds.test\"\n```\n\n### Add site to system host file\n\nAdd the following websites to the system host file (`/etc/hosts`):\n\n```conf\n127.0.0.1 teams-backgrounds.test\n```\n\n### Configure Teams\n\nTo configure the `teams-for-linux` client to use the custom backgrounds, add the following to the Teams config file:\n\n- `~/.var/app/com.github.IsmaelMartinez.teams_for_linux/config/teams-for-linux/config.json`\n\n```json\n{\n    \"isCustomBackgroundEnabled\": true,\n    \"customBGServiceBaseUrl\": \"https://teams-backgrounds.test:8081/images\",\n}\n```\n\n### Start the container\n\nTo start the container, simply run `make`, to stop run `make clean`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalebdw%2Fteams-for-linux-custom-bg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalebdw%2Fteams-for-linux-custom-bg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalebdw%2Fteams-for-linux-custom-bg/lists"}