{"id":23480464,"url":"https://github.com/qtoggle/tuya-convert-os","last_synced_at":"2025-04-14T22:55:05.903Z","repository":{"id":55518648,"uuid":"243111259","full_name":"qtoggle/tuya-convert-os","owner":"qtoggle","description":"A Raspberry Pi OS image for flashing Tuya devices with custom firmware","archived":false,"fork":false,"pushed_at":"2021-01-10T15:52:16.000Z","size":75,"stargazers_count":35,"open_issues_count":3,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-14T22:54:58.743Z","etag":null,"topics":["actuators","esp8266","firmware","home-automation","image","iot","os","qtoggle","raspberry-pi","sensors","tuya","tuya-convert"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/qtoggle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-25T21:59:28.000Z","updated_at":"2024-08-03T01:14:07.000Z","dependencies_parsed_at":"2022-08-15T02:20:11.616Z","dependency_job_id":null,"html_url":"https://github.com/qtoggle/tuya-convert-os","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtoggle%2Ftuya-convert-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtoggle%2Ftuya-convert-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtoggle%2Ftuya-convert-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtoggle%2Ftuya-convert-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qtoggle","download_url":"https://codeload.github.com/qtoggle/tuya-convert-os/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248975330,"owners_count":21192208,"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":["actuators","esp8266","firmware","home-automation","image","iot","os","qtoggle","raspberry-pi","sensors","tuya","tuya-convert"],"created_at":"2024-12-24T20:13:28.941Z","updated_at":"2025-04-14T22:55:05.877Z","avatar_url":"https://github.com/qtoggle.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Join us on Discord](https://img.shields.io/discord/742719160865521714)](https://discord.gg/wwYn3jJNPM)\n[![Join us on Facebook](https://img.shields.io/badge/chat-facebook-blue)](http://facebook.com/qtoggle)\n\n---\n\n\n## What is Tuya Convert OS?\n\nTuya Convert OS is a customized Raspbian OS image that runs\n[Tuya Convert](https://github.com/ct-Open-Source/tuya-convert) with a friendly user interface.\n\nThis tool will help you flash custom firmware on ESP8266/ESP8285-based devices that run [Tuya](https://www.tuya.com/)\nfirmware. \n\nCheck out these [screenshots](https://github.com/qtoggle/tuya-convert-os/wiki/Screenshots) if you want to see it in\naction.\n\n## Requirements\n\n * a Raspberry Pi 3 or 4 board (any model)\n * a micro SD card (any size above 2GB will do)\n * a wired network connection\n\nOptionally, the presence of a secondary Wi-Fi USB adapter will fix some cases where a 3rd Wi-Fi device has to be\nconnected to the temporary access point.\n\n\n## Getting Started\n\n1. Download Tuya Convert OS from the [releases](https://github.com/qtoggle/tuya-convert-os/releases) page.\n2. Extract the compressed image.\n3. Follow [these instructions](https://www.raspberrypi.org/documentation/installation/installing-images/) to write the\nOS image on your SD card.\n4. Connect the Raspberry Pi to your local network, using an ethernet cable.\n5. Boot your Raspberry Pi with the freshly written SD card. Find its IP address using one of the following methods (the\nhostname you should be looking for is `tuya-convert`):\n\n     * smart phone apps like Fing to scan your network\n     * looking through your router's DHCP leases\n     * an attached display will show the IP address\n     * accessing `tuya-convert.local` may work on your local network\n\n6. Point your favorite browser to `http://ipaddress` (`http://tuya-convert.local` may also work). You should see a\nweb page that will walk you through the entire conversion process.\n\n\n## Troubleshooting\n\nYou can login remotely using SSH/Putty and use default Raspbian credentials (username `pi`, password `raspberry`).\n\nThe frontend is provided by a service called `tcfrontend`. It is also responsible for spawning tuya-convert scripts in\nthe background. You can read its log using `journactl`:\n\n    journalctl -u tcfrontend -f\n\n\n## Rebuilding Image\n\nIf you want to rebuild the OS image from scratch, you'll need to:\n\n * run Linux on your laptop\n * have the following commands available: `git`, `curl`, `rsync`, `zip`, `unzip`, `losetup`, `fdisk`, `qemu-system-arm` \n\nThen simply run:\n\n    git clone https://github.com/qtoggle/tuya-convert-os.git\n    cd tuya-convert-os\n    sudo ./build.sh\n\nAt the end of a successful build, you should have a `tuya-convert-os.img` and a compressed `tuya-convert-os.zip`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqtoggle%2Ftuya-convert-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqtoggle%2Ftuya-convert-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqtoggle%2Ftuya-convert-os/lists"}