{"id":14217623,"url":"https://github.com/oskarsh/Yin-Yang","last_synced_at":"2025-08-09T11:31:36.747Z","repository":{"id":37036016,"uuid":"162924116","full_name":"oskarsh/Yin-Yang","owner":"oskarsh","description":"Auto Nightmode for KDE, Gnome, Budgie, VSCode, Atom and more","archived":false,"fork":false,"pushed_at":"2024-06-19T18:32:04.000Z","size":24802,"stargazers_count":579,"open_issues_count":36,"forks_count":51,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-06-22T05:05:00.833Z","etag":null,"topics":["budgie","gnome","kde","kde-plasma-5","linux","night-mode","nightmode","themes","yin-yang"],"latest_commit_sha":null,"homepage":"","language":"Python","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/oskarsh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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":null,"patreon":"L0drex","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2018-12-23T21:10:47.000Z","updated_at":"2024-06-22T05:05:13.779Z","dependencies_parsed_at":"2023-02-09T04:30:39.999Z","dependency_job_id":"eb67d0d2-9d0d-4079-9d96-801cc6493ca3","html_url":"https://github.com/oskarsh/Yin-Yang","commit_stats":{"total_commits":561,"total_committers":48,"mean_commits":11.6875,"dds":0.3440285204991087,"last_synced_commit":"f855d77f7a50572223459bbad67abce062c8b310"},"previous_names":["daehruoydeef/yin-yang"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oskarsh%2FYin-Yang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oskarsh%2FYin-Yang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oskarsh%2FYin-Yang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oskarsh%2FYin-Yang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oskarsh","download_url":"https://codeload.github.com/oskarsh/Yin-Yang/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":208178849,"owners_count":14828919,"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":["budgie","gnome","kde","kde-plasma-5","linux","night-mode","nightmode","themes","yin-yang"],"created_at":"2024-08-19T15:00:21.987Z","updated_at":"2025-08-09T11:31:36.731Z","avatar_url":"https://github.com/oskarsh.png","language":"Python","funding_links":["https://patreon.com/L0drex","https://opencollective.com/Yin-Yang/organization/0/website","https://opencollective.com/Yin-Yang/organization/1/website","https://opencollective.com/Yin-Yang/organization/2/website","https://opencollective.com/Yin-Yang/organization/3/website","https://opencollective.com/Yin-Yang/organization/4/website","https://opencollective.com/Yin-Yang/organization/5/website","https://opencollective.com/Yin-Yang/organization/6/website","https://opencollective.com/Yin-Yang/organization/7/website","https://opencollective.com/Yin-Yang/organization/8/website","https://opencollective.com/Yin-Yang/organization/9/website"],"categories":["Applications","Uncategorized","Python"],"sub_categories":["Utilities \u0026 Tools","Uncategorized"],"readme":"# ![Yin \u0026 Yang logo](resources/icon.svg) Yin-Yang\n\n![](https://img.shields.io/github/v/release/oskarsh/yin-yang)\n![](https://img.shields.io/github/v/release/oskarsh/yin-yang?include_prereleases)\n![](https://img.shields.io/github/downloads/oskarsh/yin-yang/total)\n![](https://img.shields.io/badge/Build%20with-Python-yellow)\n![](https://img.shields.io/github/license/oskarsh/yin-yang)\n\nAuto Night-mode for Linux, it supports popular Desktops like KDE, GNOME, Budgie\nand also themes your favourite editors like VSCode or Atom.\n\nYou might also want to take a look at our [**discussions page**](https://github.com/oskarsh/Yin-Yang/discussions), where we talk about the future of the app and other cool stuff!\n\n![Visualization](.github/images/header.png)\n![App configuration](.github/images/settings.png)\n\n## Features\n\n- Changes your themes at certain times or sunrise and sunset\n- Supported Desktops:\n  - GNOME\n  - Budgie\n  - KDE Plasma\n- Supported applications:\n  - VSCode, Atom, gedit\n  - Firefox \u0026 Brave\n  - Kvantum\n  - Konsole\n  - OnlyOffice\n  - and more...\n- Miscellaneous:\n  - Wallpaper change\n  - Notifications on theme change\n  - Play a sound\n  - Ability to run custom scripts\n\n\u003e To see planned features and the development status, visit the [project status page](https://github.com/oskarsh/Yin-Yang/projects?type=classic).\n\n## Installation\n\n### Flatpak\n\n```bash\n# follow the development setup\npoetry build\n# see https://github.com/flatpak/flatpak-builder/issues/237 if you have issues with rofiles\nflatpak-builder --install --user build sh.oskar.yin_yang.json --force-clean\n```\n\n### Arch-based distributions\n\nYin-Yang can be downloaded from AUR as [yin-yang](https://aur.archlinux.org/packages/yin-yang) package.\n\n### Source\n\nYin-Yang depends on `python-systemd` and `pyside6` from pypi. `python-systemd` requires you have installed the systemd-headers from your package manager. You also need python development headers (e.g. `python3-devel`) and the poetry build system for python.\nPreferably install `PySide6-Essentials` and `PySide6-Addons` from your system package manager as well.\nIf they are not available there, uncomment the dependencies in `pyproject.toml`.\n\nFor CentOS, RHEL, and Fedora:\n\n```bash\nsudo dnf install gcc systemd-devel python3-devel libnotify poetry python3-pyside6\n```\n\nFor OpenSUSE:\n\n```bash\nsudo zypper refresh\nsudo zypper install gcc systemd-devel libnotify python311-poetry python3-PySide6\n```\n\nFor Debian, Ubuntu, etc.\n\n```bash\nsudo apt update\nsudo apt install libsystemd-dev gcc pkg-config python3-dev libnotify-bin python3-poetry python3-qtpy-pyside6\n```\n\nThen you can install Yin-Yang in a python virtual environment:\n\n```bash\n# bash is necessary to run the source command\nbash\n# Clones the code to your local machine\ngit clone https://github.com/oskarsh/Yin-Yang.git\ncd Yin-Yang\n# Installs Yin-Yang\n./scripts/install.sh\n```\n\nFor development, skip the installation and instead build python using Poetry. A virtual environment will be created for you:\n\n```bash\n# Load into virtual environment\npoetry env use python\n# Install dependencies\npoetry sync\n# Load Yin-Yang\npoetry run python -m yin_yang\n```\n\nMake sure to run `flake8` on your files to avoid errors from the ci in PRs:\n```bash\npoetry run flake8\n```\n\n### Uninstall\n\nRun `scripts/uninstall.sh` from a terminal and fill out the password.\n\n## Documentation\n\nWant to help out? Check out the wiki to learn how to contribute translations, plugins and more!\n\n[![Generic badge](https://img.shields.io/badge/Visit-Wiki-BLUE.svg)](https://github.com/oskarsh/Yin-Yang/wiki)\n\n## Related or similar projects\n\n- Auto dark mode for Windows: https://github.com/AutoDarkMode/Windows-Auto-Night-Mode\n- Auto dark mode extension for GNOME: https://extensions.gnome.org/extension/2236/night-theme-switcher/\n- Auto dark mode for Jetbrains IDEs: https://github.com/weisJ/auto-dark-mode\n- Sync dark mode with KDEs night color: https://github.com/adrium/knightadjuster\n- darkman: https://gitlab.com/WhyNotHugo/darkman\n- In Firefox, you can use the system theme to sync Firefox itself and supported applications with the theme of the system. When you use [dark reader](https://darkreader.org/), you can enable the system color automation.\n\n## Thanks to all Contributors\n\n### Code Contributors\n\nThis project exists thanks to all the people who contribute. [[Contribute](https://github.com/oskarsh/Yin-Yang/wiki/Contributing)].\n\n[![](https://opencollective.com/Yin-Yang/contributors.svg?button=false)](https://github.com/oskarsh/Yin-Yang/graphs/contributors)\n\n### Donate\n\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/0/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/0/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/1/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/1/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/2/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/2/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/3/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/3/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/4/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/4/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/5/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/5/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/6/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/6/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/7/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/7/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/8/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/8/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/Yin-Yang/organization/9/website\"\u003e\u003cimg src=\"https://opencollective.com/Yin-Yang/organization/9/avatar.svg\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foskarsh%2FYin-Yang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foskarsh%2FYin-Yang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foskarsh%2FYin-Yang/lists"}