{"id":18928481,"url":"https://github.com/nathan-osman/webmail-notifier-linux-driver","last_synced_at":"2025-07-29T00:08:44.098Z","repository":{"id":6344580,"uuid":"7580806","full_name":"nathan-osman/Webmail-Notifier-Linux-Driver","owner":"nathan-osman","description":"A Linux device driver for the Dream Cheeky USB Webmail Notifier.","archived":false,"fork":false,"pushed_at":"2013-10-07T20:51:06.000Z","size":300,"stargazers_count":9,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T16:48:48.957Z","etag":null,"topics":["driver","linux","module"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nathan-osman.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}},"created_at":"2013-01-12T21:33:11.000Z","updated_at":"2020-05-25T10:30:42.000Z","dependencies_parsed_at":"2022-09-01T06:32:06.800Z","dependency_job_id":null,"html_url":"https://github.com/nathan-osman/Webmail-Notifier-Linux-Driver","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nathan-osman/Webmail-Notifier-Linux-Driver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathan-osman%2FWebmail-Notifier-Linux-Driver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathan-osman%2FWebmail-Notifier-Linux-Driver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathan-osman%2FWebmail-Notifier-Linux-Driver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathan-osman%2FWebmail-Notifier-Linux-Driver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nathan-osman","download_url":"https://codeload.github.com/nathan-osman/Webmail-Notifier-Linux-Driver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathan-osman%2FWebmail-Notifier-Linux-Driver/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267606603,"owners_count":24114761,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["driver","linux","module"],"created_at":"2024-11-08T11:26:01.825Z","updated_at":"2025-07-29T00:08:44.080Z","avatar_url":"https://github.com/nathan-osman.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Webmail Notifier Linux Driver\n\nThis project intends to create a working Linux device driver for the [Dream Cheeky USB Webmail Notifier](http://www.dreamcheeky.com/webmail-notifier).\n\n### The Device\n\nThe device itself consists of a small plastic shell in the shape of an envelope. According to the website, its physical dimensions are approximately 4.7cm x 7.5cm x 3 cm. The picture below demonstrates its appearance when lit:\n\n![](http://i.stack.imgur.com/EaltB.png)\n\nOn a more technical note, the USB vendor and product ID are as follows:\n\n**Vender:** `1d34`  \n**Product:** `0004`\n\n### The Protocol\n\nThis device employs an extremely simple protocol. Using a USB logging tool, I discovered that the device consists of three LEDs - one red, one green, and one blue. They can each be set to one of 0x40 different intensities.\n\nA sample block of data sent to the device to make it appear blue would look like this:\n\n    00 00 40 00 00 00 1f 05\n\nI have no idea what the `1f 05` is for, but it seems to exist in every command dispatched, so I include it when sending commands to the device. Perhaps some more experimentation will reveal its purpose.\n\n### Building the Module\n\nBuilding the module is easy if you have the headers for your current kernel installed. Just run:\n\n    make\n\n### Using the Module\n\nYou can load the module into the kernel with:\n\n    insmod webmail_notifier.ko\n\nAssuming you either have the device plugged in or plug it in after loading the module, you should have a file `/dev/wn0` that you can use to control the device. Color values are specified using CSS hex notation:\n\n    echo \"#ff0000\" \u003e/dev/wn0\n\nUsing the above command will set the device color to red.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathan-osman%2Fwebmail-notifier-linux-driver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnathan-osman%2Fwebmail-notifier-linux-driver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathan-osman%2Fwebmail-notifier-linux-driver/lists"}