{"id":13766968,"url":"https://github.com/wasp-os/wasp-os","last_synced_at":"2025-05-16T00:05:05.904Z","repository":{"id":36997096,"uuid":"234031876","full_name":"wasp-os/wasp-os","owner":"wasp-os","description":"A MicroPython based development environment for smart watches (including Pine64 PineTime)","archived":false,"fork":false,"pushed_at":"2025-04-20T11:57:29.000Z","size":1900,"stargazers_count":870,"open_issues_count":113,"forks_count":231,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-05-14T04:08:56.556Z","etag":null,"topics":["micropython","pinetime","smartwatch"],"latest_commit_sha":null,"homepage":"https://wasp-os.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wasp-os.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"docs/contributing.rst","funding":null,"license":"COPYING","code_of_conduct":"docs/code_of_conduct.rst","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}},"created_at":"2020-01-15T08:16:01.000Z","updated_at":"2025-05-12T23:18:09.000Z","dependencies_parsed_at":"2023-02-12T16:15:54.037Z","dependency_job_id":"98fd35a6-c030-4eb4-b18f-b1df09192bb6","html_url":"https://github.com/wasp-os/wasp-os","commit_stats":{"total_commits":693,"total_committers":47,"mean_commits":14.74468085106383,"dds":"0.20779220779220775","last_synced_commit":"bf07f0cf551cfec5253b7efe38673d6ae13986bb"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wasp-os%2Fwasp-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wasp-os%2Fwasp-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wasp-os%2Fwasp-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wasp-os%2Fwasp-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wasp-os","download_url":"https://codeload.github.com/wasp-os/wasp-os/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254442854,"owners_count":22071878,"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":["micropython","pinetime","smartwatch"],"created_at":"2024-08-03T16:01:03.055Z","updated_at":"2025-05-16T00:05:05.876Z","avatar_url":"https://github.com/wasp-os.png","language":"Python","funding_links":[],"categories":["Projects by Operating System"],"sub_categories":["WASP OS"],"readme":"Watch Application System in Python\n==================================\n\nIntroduction\n------------\n\nWasp-os is a firmware for smart watches that are based on the nRF52 family of\nmicrocontrollers, and especially for hacker friendly watches such as the Pine64\nPineTime. Wasp-os features full heart rate monitoring and step counting support\ntogether with multiple clock faces, a stopwatch, an alarm clock, a countdown\ntimer, a calculator and lots of other games and utilities. All of this, and\nstill with access to the MicroPython REPL for interactive tweaking, development\nand testing.\n\nWasp-os comes fully integrated with a robust bootloader based on the Adafruit\nNRF52 Bootloader. The bootloader has been extended to make it robust for\ndevelopment on form-factor devices without a reset button, power switch, SWD\ndebugger or UART. This allows us to confidently develop on sealed devices\nrelying on Bluetooth Low Energy for over-the-air updates.\n\nDocumentation\n-------------\n\nWasp-os is has `extensive documentation \u003chttps://wasp-os.readthedocs.io\u003e`_\nwhich includes a detailed `Application Writer's Guide\n\u003chttps://wasp-os.readthedocs.io/en/latest/appguide.html\u003e`_ to help you\nget started coding for wasp-os as quickly as possible.\n\nGetting Started\n---------------\n\nWasp-os can be installed without using any tools or disassembly onto the\nfollowing devices:\n\n * Pine64 PineTime\n * Colmi P8\n * Senbono K9\n\nUse the\n`Installation Guide \u003chttps://wasp-os.readthedocs.io/en/latest/install.html\u003e`_\nto learn how to build and install wasp-os on these devices.\n\nAt the end of the install process your watch will show the time (03:00)\ntogether with a date and a battery meter. When the watch goes into power\nsaving mode you can use the button to wake it again.\n\nAt this point you will also be able to use the Nordic UART Service to\naccess the MicroPython REPL. You can use ``tools/wasptool --console``\nto access the MicroPython REPL.\n\nTo set the time and restart the main application:\n\n.. code-block:: python\n\n   ^C\n   watch.rtc.set_localtime((yyyy, mm, dd, HH, MM, SS))\n   wasp.system.run()\n\nOr, if you have a suitable GNU/Linux workstation, just use:\n\n.. code-block:: sh\n\n   ./tools/wasptool --rtc\n\nwhich can run these commands automatically.\n\nAs mentioned above there are many drivers and features still to be\ndeveloped, see the :ref:`Roadmap` for current status.\n\nCommunity\n---------\n\nThe wasp-os community is centred around the\n`github project \u003chttps://github.com/wasp-os/wasp-os\u003e`_ and is\nsupplemented with instant messaging in the\n`#wasp-os:matrix.org \u003chttps://matrix.to/#/#wasp-os:matrix.org\u003e`_\nchannel. If you do not have a preferred Matrix chat client then we recommend\ntrying out the\n`Element web client \u003chttps://app.element.io/#/room/#wasp-os:matrix.org\u003e`_\nFollow the element link and, if you do not already have a matrix account,\nregister yourself. That should be enough to get you chatting!\n\nAlternatively, if you prefer to use IRC then, for all\n`the usual reasons \u003chttps://xkcd.com/1782/\u003e`_ the Matrix channel is also\nbridged to the #wasp-os IRC channel at libera.chat.\n\nVideos\n------\n\n.. list-table::\n\n   * - .. figure:: res/thumbnail-nps8Kd2qPzs.jpg\n          :target: https://www.youtube.com/watch?v=nps8Kd2qPzs\n          :alt: wasp-os: A tour of the new applications for wasp-os\n          :width: 95%\n\n          `A tour of the new applications for wasp-os \u003chttps://www.youtube.com/watch?v=nps8Kd2qPzs\u003e`_\n\n     - .. figure:: https://img.youtube.com/vi/lIo2-djNR48/0.jpg\n          :target: https://www.youtube.com/watch?v=lIo2-djNR48\n          :alt: wasp-os: Open source heart rate monitoring for Pine64 PineTime\n          :width: 95%\n\n          `Open source heart rate monitoring for Pine64 PineTime \u003chttps://www.youtube.com/watch?v=lIo2-djNR48\u003e`_\n\n   * - .. figure:: https://img.youtube.com/vi/YktiGUSRJB4/0.jpg\n          :target: https://www.youtube.com/watch?v=YktiGUSRJB4\n          :alt: An M2 pre-release running on Pine64 PineTime\n          :width: 95%\n\n          `An M2 pre-release running on Pine64 PineTime \u003chttps://www.youtube.com/watch?v=YktiGUSRJB4\u003e`_\n\n     - .. figure:: https://img.youtube.com/vi/tuk9Nmr3Jo8/0.jpg\n          :target: https://www.youtube.com/watch?v=tuk9Nmr3Jo8\n          :alt: How to develop wasp-os python applications on a Pine64 PineTime\n          :width: 95%\n\n          `How to develop wasp-os python applications on a Pine64 PineTime \u003chttps://www.youtube.com/watch?v=tuk9Nmr3Jo8\u003e`_\n\n   * - .. figure:: https://img.youtube.com/vi/kf1VHj587Mc/0.jpg\n          :target: https://www.youtube.com/watch?v=kf1VHj587Mc\n          :alt: Developing for Pine64 PineTime using wasp-os and MicroPython\n          :width: 95%\n\n          `Developing for Pine64 PineTime using wasp-os and MicroPython \u003chttps://www.youtube.com/watch?v=kf1VHj587Mc\u003e`_\n\n     -\n\nCustom builds\n-------------\n\nWasp-os is designed to allow users to easily create their own custom builds. Simply modify the wasp.toml file\nto include your favorite apps and watch faces. See the docs for more information on how to build wasp-os.\n\nScreenshots\n-----------\n\n(An older version of) the digital clock application running on a Pine64\nPineTime:\n\n.. image:: res/clock_app.jpg\n   :alt: wasp-os digital clock app running on PineTime\n   :width: 233\n\nScreenshots of the available applications running on the wasp-os\nsimulator:\n\n.. image:: res/Bootloader.png\n   :alt: Bootloader splash screen overlaid on the simulator watch art\n   :width: 179\n\nWatch faces:\n\n.. image:: res/screenshots/ClockApp.png\n   :alt: Digital clock application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/WeekClockApp.png\n   :alt: Digital clock application with week day running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/ChronoApp.png\n   :alt: Analogue clock application running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/DualClockApp.png\n   :alt: An other clock application running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/FibonacciClockApp.png\n   :alt: Fibonacci clock application running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/WordClockApp.png\n   :alt: Shows a time as words in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/ResistorClockApp.png\n   :alt: Resistor colour code clock application running in the wasp-os simulator\n   :width: 179\n\nGames:\n\n.. image:: res/screenshots/Play2048App.png\n   :alt: Let's play the 2048 game (in the wasp-os simulator)\n   :width: 179\n\n.. image:: res/screenshots/GameOfLifeApp.png\n   :alt: Game of Life running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/SnakeApp.png\n   :alt: Snake Game running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/Puzzle15App.png\n   :alt: 15 Puzzle running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/FourInARowApp.png\n   :alt: Four In A Row running in the wasp-os simulator\n   :width: 179\n\nTime management apps:\n\n.. image:: res/screenshots/AlarmApp.png\n   :alt: Alarm clock application running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/StopwatchApp.png\n   :alt: Stop watch application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/TimerApp.png\n   :alt: Countdown timer application running in the wasp-os simulator\n   :width: 179\n\nSystem apps:\n\n.. image:: res/screenshots/DisaBLEApp.png\n   :alt: Small application for disabling bluetooth to save power and enhance security\n   :width: 179\n\n.. image:: res/screenshots/LauncherApp.png\n   :alt: Application launcher running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/SettingsApp.png\n   :alt: Settings application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/SoftwareApp.png\n   :alt: Software selection app running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/FacesApp.png\n   :alt: Switch watch faces\n   :width: 179\n\n\nOther apps: (The \"blank\" white screenshot is a flashlight app)\n\n.. image:: res/screenshots/BeaconApp.png\n   :alt: Flash the relatively powerful HRS LED repeatedly\n   :width: 179\n\n.. image:: res/screenshots/CalculatorApp.png\n   :alt: Calculator running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/DemoApp.png\n   :alt: Simple always-on demo for showing off wasp-os at conferences and shows\n   :width: 179\n\n.. image:: res/screenshots/FlashlightApp.png\n   :alt: Torch application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/GalleryApp.png\n   :alt: Gallery application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/HeartApp.png\n   :alt: Heart rate application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/HaikuApp.png\n   :alt: Haiku application running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/LevelApp.png\n   :alt: Shows a time as words in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/MorseApp.png\n   :alt: Morse translator/notepad application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/PomodoroApp.png\n   :alt: Customizable pomodoro app with randomized vibration patterns to make sure you notice\n   :width: 179\n\n.. image:: res/screenshots/PhoneFinderApp.png\n   :alt: Find your phone by causing it to ring\n   :width: 179\n\n.. image:: res/screenshots/SportsApp.png\n   :alt: Sports applications, a combined stopwatch and step counter\n   :width: 179\n\n.. image:: res/screenshots/StepCounterApp.png\n   :alt: Step counter application running on the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/TestApp.png\n   :alt: Self test application running a rendering benchmark on the simulator\n   :width: 179\n\n.. image:: res/screenshots/MusicPlayerApp.png\n   :alt: Music Player running in the wasp-os simulator\n   :width: 179\n\n.. image:: res/screenshots/WeatherApp.png\n   :alt: Weather application running in the wasp-os simulator\n   :width: 179\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwasp-os%2Fwasp-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwasp-os%2Fwasp-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwasp-os%2Fwasp-os/lists"}