{"id":13746190,"url":"https://github.com/wimpysworld/argon1-ubuntu","last_synced_at":"2025-04-26T10:31:27.136Z","repository":{"id":102994205,"uuid":"282213061","full_name":"wimpysworld/argon1-ubuntu","owner":"wimpysworld","description":"Argon 1 Case and Argon Fan HAT controller for Ubuntu","archived":false,"fork":false,"pushed_at":"2022-09-23T13:23:55.000Z","size":437,"stargazers_count":71,"open_issues_count":2,"forks_count":13,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-04T11:46:59.565Z","etag":null,"topics":["argon","fan-hat","gpio","hacktoberfest","raspberry-pi","ubuntu"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/watch?v=b1kG7XUvw5E","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wimpysworld.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"flexiondotorg","patreon":"wimpysworld","custom":"https://wimpysworld.io/tip"}},"created_at":"2020-07-24T12:21:42.000Z","updated_at":"2024-09-28T13:50:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"fb100551-cde8-49a3-a60a-fd6b24bd6abb","html_url":"https://github.com/wimpysworld/argon1-ubuntu","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fargon1-ubuntu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fargon1-ubuntu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fargon1-ubuntu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wimpysworld%2Fargon1-ubuntu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wimpysworld","download_url":"https://codeload.github.com/wimpysworld/argon1-ubuntu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250972831,"owners_count":21516431,"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":["argon","fan-hat","gpio","hacktoberfest","raspberry-pi","ubuntu"],"created_at":"2024-08-03T06:00:49.519Z","updated_at":"2025-04-26T10:31:26.588Z","avatar_url":"https://github.com/wimpysworld.png","language":"Shell","funding_links":["https://github.com/sponsors/flexiondotorg","https://patreon.com/wimpysworld","https://wimpysworld.io/tip"],"categories":["Software"],"sub_categories":["argon1.sh"],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\".github/argononecase.jpg\" alt=\"Argon Fan Controller\" width=\"256\" /\u003e\n  \u003cbr /\u003e\n  Argon Fan Controller\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003eArgon Fan HAT / Argon ONE Case Fan Controller for Ubuntu\u003c/b\u003e\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\u003cimg src=\".github/argononefanhat.jpg\" alt=\"Argon Fan HAT\" /\u003e\u003c/div\u003e\n\u003cp align=\"center\"\u003eMade with 💝 for \u003cimg src=\".github/ubuntu.png\" align=\"top\" width=\"18\" /\u003e\u003c/p\u003e\n\n## Introduction\n\n`argon1.sh` is a refactored version of the Argon FanHAT / Argon ONE Case Fan\ncontroller for Ubuntu and is derived from the origin script published by\n[Argon Forty](https://www.argon40.com/) here:\n\n  * \u003chttps://download.argon40.com/argon1.sh\u003e\n\nThe refactor consisted of:\n\n  * Adds support for Ubuntu by reading temps from sysfs.\n  * Adds support for Ubuntu 20.04 by only using Python 3.\n  * Uses [here documents](https://en.wikipedia.org/wiki/Here_document) to make the script easier to read/maintain.\n  * Simplifies install/uninstall via an option parser.\n  * Removes the config script and desktop icons.\n\nWe have a Discord for this project: [![Discord](https://img.shields.io/discord/712850672223125565?color=0C306A\u0026label=WimpysWorld%20Discord\u0026logo=Discord\u0026logoColor=ffffff\u0026style=flat-square)](https://discord.gg/wG8bAra)\n\n[![Raspberry Pi Argon Fan HAT \u0026 Argon ONE Case Fan controller for Ubuntu](https://img.youtube.com/vi/b1kG7XUvw5E/0.jpg)](https://www.youtube.com/watch?v=b1kG7XUvw5E)\n\n## Installation\n\nThis script will only work on [Ubuntu running on a Raspberry Pi](https://ubuntu.com/download/raspberry-pi).\n\n  * Clone the project\n    * `git clone https://github.com/wimpysworld/argon1-ubuntu.git`\n  * Install the fan controller\n    * `cd argon1-ubuntu`\n    * `sudo ./argon1-ubuntu --install`\n\n### Usage\n\n```\nUsage\n  $0 [options]\n\nAvailable options are\n  --config      Get help about how to configure the fan\n  --install     Install the Argon ONE Case Fan / Argon FanHAT driver\n  --uninstall   Uninstall the Argon ONE Case Fan / Argon FanHAT driver\n```\n\nTo modify you fan curve edit `/etc/argononed.conf` and then execute\n`sudo systemctl restart argononed.service` to made the changes active.\n\n### Argon ONE Pi 4 Power Button Functions\n\n| Power State |     Action    | Function |\n|:-----------:|:-------------:|:--------:|\n| OFF         | Short Press   | Turn ON|\n| ON          | Long Press (\u003e=3s) | Soft Shutdown and Power Cut |\n| ON          | Short Press (\u003c=3s) | Nothing |\n| ON          | Double Tap    | Reboot |\n| ON          | Long Press (\u003e=5s) | Forced Shutdown |\n\n### Argon Fan HAT Power Button Functions\n\n| Power State |     Action    | Function |\n|:-----------:|:-------------:|:--------:|\n| OFF         | Short Press   | Nothing|\n| ON          | Long Press (\u003e=3s) | Soft Shutdown and Power Cut |\n| ON          | Short Press (\u003c=3s) | Nothing |\n| ON          | Double Tap    | Reboot |\n| ON          | Long Press (\u003e=5s) | Forced Shutdown |\n\n## Credits\n\n  * Thanks to [kounch](https://github.com/kounch/) for their [Arch Linux PKGBUILD for Argon One](https://github.com/kounch/argonone).\n  * Thanks to [Cédric Meuter](https://github.com/meuter) for their [argon1.sh adapted for Ubuntu 20.04](https://github.com/meuter/argon-one-case-ubuntu-20.04).\n\n## TODO\n\n- [ ] Confirm Argon Fan HAT works on Pi 2, 3 and 4.\n- [ ] Replace use of `os.system()`.\n- [ ] Clean up parsing of the config file.\n\n## DONE\n\n- [x] Read `/sys/class/thermal/thermal_zone0/temp` in a Pythonic way.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwimpysworld%2Fargon1-ubuntu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwimpysworld%2Fargon1-ubuntu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwimpysworld%2Fargon1-ubuntu/lists"}