{"id":42403701,"url":"https://github.com/quinsaiz/weather-effect","last_synced_at":"2026-01-28T01:28:22.040Z","repository":{"id":322996230,"uuid":"965157417","full_name":"quinsaiz/weather-effect","owner":"quinsaiz","description":"Weather Effect is a GNOME Shell extension that adds beautiful animated weather effects (snow or rain) to your desktop wallpaper or as a full-screen overlay. Enjoy the magic of falling snowflakes or raindrops on your GNOME desktop!","archived":false,"fork":false,"pushed_at":"2025-12-10T18:08:39.000Z","size":125,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-11T04:35:01.553Z","etag":null,"topics":["effects","extension","gnome","rain","snow"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quinsaiz.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-12T14:40:16.000Z","updated_at":"2025-12-10T18:08:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/quinsaiz/weather-effect","commit_stats":null,"previous_names":["quinsaiz/weather-effect"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/quinsaiz/weather-effect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quinsaiz%2Fweather-effect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quinsaiz%2Fweather-effect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quinsaiz%2Fweather-effect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quinsaiz%2Fweather-effect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quinsaiz","download_url":"https://codeload.github.com/quinsaiz/weather-effect/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quinsaiz%2Fweather-effect/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28831387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T23:29:49.665Z","status":"ssl_error","status_checked_at":"2026-01-27T23:25:58.379Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["effects","extension","gnome","rain","snow"],"created_at":"2026-01-28T01:28:21.374Z","updated_at":"2026-01-28T01:28:22.032Z","avatar_url":"https://github.com/quinsaiz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eWeather Effect GNOME Extension\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/GNOME-Shell-blue?style=for-the-badge\u0026logo=gnome\" alt=\"GNOME Shell\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-GPLv3-green?style=for-the-badge\" alt=\"License\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Version-2.0-orange?style=for-the-badge\" alt=\"Version\"/\u003e\n\u003c/p\u003e\n\n## Description\n\nWeather Effect is a GNOME Shell extension that adds beautiful animated weather effects (snow or rain) to your desktop wallpaper or as a full-screen overlay. Enjoy the magic of falling snowflakes or raindrops on your GNOME desktop!\n\n### Key Features:\n\n- ❄️ **Snow Effect**: Beautiful animated snowflakes falling on your desktop\n- 🌧️ **Rain Effect**: Realistic rain animation with customizable particles\n- **Display Modes**:\n  - **Wallpaper Mode**: Effects only on desktop wallpaper background\n  - **Screen Mode**: Full-screen overlay that works even in overview\n- **Customizable Settings**:\n  - Particle count (5-50)\n  - Particle size (4-32 pixels)\n  - Speed control (Slow, Medium, Fast)\n  - Color customization for snow and rain\n  - Custom emoji support (❄, ❅, ❆, 💧)\n- **Multi-Monitor Support**: Automatically works across all connected monitors\n- **Smart Behavior**: Pauses when desktop is obscured by fullscreen windows\n- **Quick Settings Integration**: Easy access through GNOME Quick Settings menu\n\n## Installation\n\n### Prerequisites\n\n- GNOME Shell 45+\n\n### Quick Installation\n\n1. **Download last [weather-effect@quinsaiz.github.shell-extension.zip](https://github.com/quinsaiz/weather-effect/releases)**\n\n2. **Install:**\n\n   ```bash\n   gnome-extensions install weather-effect@quinsaiz.github.shell-extension.zip\n   ```\n\n3. **Log out and log back in**\n\n## Building from Source\n\nIf you want to build the extension from source code, follow these steps:\n\n### Prerequisites for Building\n\n- **[Node.js](https://nodejs.org/)** (v16 or higher)\n- **npm** (comes with Node.js)\n- **glib-compile-schemas** (usually comes with GNOME development packages)\n\n#### Ubuntu/Debian:\n\n```bash\nsudo apt install nodejs npm gir1.2-glib-2.0\n```\n\n#### Fedora:\n\n```bash\nsudo dnf install nodejs npm glib2-devel\n```\n\n#### Arch:\n\n```bash\nsudo pacman -S nodejs npm glib2\n```\n\n### Build Steps\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/quinsaiz/weather-effect.git\n   cd weather-effect\n   ```\n\n2. **Install dependencies:**\n\n   ```bash\n   npm i\n   ```\n\n3. **Build the extension:**\n\n   ```bash\n   npm run build\n   ```\n\n   This will:\n\n   - Compile TypeScript files to JavaScript\n   - Create the extension archive (.zip) and install it\n\n## Usage\n\n1. **Open Quick Settings** by clicking the system menu in the top-right corner\n2. **Click the Weather Effect toggle** (weather icon)\n3. **Select effect type**:\n   - Choose between **Snow** ❄️ or **Rain** 🌧️ using the horizontal selector buttons\n4. **Configure settings** (optional):\n   - Open GNOME Extensions app\n   - Click the ⚙️ gear icon next to Weather Effect\n   - Adjust particle count, size, speed, colors, and display mode\n\n## Project Structure\n\n```text\nweather-effect/\n│\n├── src/\n│   ├── extension.ts           # Main extension entry point\n│   ├── metadata.json          # Extension manifest\n│   ├── prefs.ts               # Preferences window\n│   └── lib/\n│       ├── WeatherEffectController.ts  # Main orchestrator\n│       ├── UIManager.ts                # Quick Settings UI components\n│       ├── MonitorManager.ts           # Monitor actor management\n│       ├── ObscurationManager.ts       # Window obscuration detection\n│       ├── ParticleManager.ts          # Particle creation \u0026 animation\n│       └── Debug.ts                    # Centralized logging\n│\n├── schemas/\n│   └── org.gnome.shell.extensions.weather-effect.gschema.xml\n│\n├── scripts/\n│   └── build.sh          # Build and installation script\n│\n├── package.json          # Dependencies \u0026 build scripts\n├── tsconfig.json         # TypeScript compiler options\n├── LICENSE               # GPLv3 License\n└── README.md             # This file\n```\n\n## Configuration\n\nThe extension can be configured through the GNOME Extensions app settings:\n\n- **Effect Type**: Snow or Rain\n- **Display Mode**: Wallpaper only or Full screen overlay\n- **Particle Count**: 5 to 50 particles\n- **Particle Size**: 4 to 32 pixels\n- **Speed**: Slow, Medium, or Fast\n- **Snow Color**: White, Light Blue, or Silver\n- **Rain Color**: Gray or Dark Blue\n- **Custom Emojis**: Choose custom emoji or use default shapes\n\n## Author\n\n### quinsaiz\n\nGitHub: https://github.com/quinsaiz\n\n## License\n\nThis project is licensed under the [GPLv3 License](/LICENSE).\n\n## Support\n\nIf you like this project, please give it a star on GitHub!\n\n[![GitHub stars](https://img.shields.io/github/stars/quinsaiz/weather-effect?style=social)](https://github.com/quinsaiz/weather-effect)\n\n## Contributing\n\nContributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/quinsaiz/weather-effect/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquinsaiz%2Fweather-effect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquinsaiz%2Fweather-effect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquinsaiz%2Fweather-effect/lists"}