{"id":31567909,"url":"https://github.com/maxonxoxo/customlcd","last_synced_at":"2026-04-17T02:31:10.886Z","repository":{"id":309943146,"uuid":"1037488078","full_name":"MaxonXOXO/CustomLCD","owner":"MaxonXOXO","description":"ESP8266-powered Wi-Fi LCD clock with big custom-character digits, NTP-based time sync, 12-hour format, dynamic greetings, and multiple Wi-Fi credential support.","archived":false,"fork":false,"pushed_at":"2025-08-24T11:11:24.000Z","size":4527,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-24T17:07:11.664Z","etag":null,"topics":["12-hour-format","custom-characters","esp8266","internet-clock","iot","lcd","lcd-display","nodemcu","ntp-clock","wifi-clock"],"latest_commit_sha":null,"homepage":"","language":"C++","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/MaxonXOXO.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-13T16:42:06.000Z","updated_at":"2025-08-24T11:11:28.000Z","dependencies_parsed_at":"2025-08-14T18:49:25.794Z","dependency_job_id":"ff55d860-a55a-4aaa-81ae-46c3805a6419","html_url":"https://github.com/MaxonXOXO/CustomLCD","commit_stats":null,"previous_names":["maxonxoxo/customlcd"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/MaxonXOXO/CustomLCD","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxonXOXO%2FCustomLCD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxonXOXO%2FCustomLCD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxonXOXO%2FCustomLCD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxonXOXO%2FCustomLCD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MaxonXOXO","download_url":"https://codeload.github.com/MaxonXOXO/CustomLCD/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxonXOXO%2FCustomLCD/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278437949,"owners_count":25986760,"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-10-05T02:00:06.059Z","response_time":54,"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":["12-hour-format","custom-characters","esp8266","internet-clock","iot","lcd","lcd-display","nodemcu","ntp-clock","wifi-clock"],"created_at":"2025-10-05T09:46:11.627Z","updated_at":"2025-10-05T09:46:18.623Z","avatar_url":"https://github.com/MaxonXOXO.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n___  ___  ___  __   _______ _   _ __   _________   _______  \n|  \\/  | / _ \\ \\ \\ / /  _  | \\ | |\\ \\ / /  _  \\ \\ / /  _  | \n| .  . |/ /_\\ \\ \\ V /| | | |  \\| | \\ V /| | | |\\ V /| | | | \n| |\\/| ||  _  | /   \\| | | | . ` | /   \\| | | |/   \\| | | | \n| |  | || | | |/ /^\\ \\ \\_/ / |\\  |/ /^\\ \\ \\_/ / /^\\ \\ \\_/ / \n\\_|  |_/\\_| |_/\\/   \\/\\___/\\_| \\_/\\/   \\/\\___/\\/   \\/\\___/  \n                                                            \n\n```\n\n# ESP8266 LCD Clock (Wi-Fi + NTP)\n\nThis project is a **custom-character big digit LCD clock** using an **ESP8266 NodeMCU** with **I2C LCD**.  \nThe time is fetched from the internet via **NTP** and automatically adjusted for **India Standard Time (UTC+5:30)**.  \nIt also supports:\n- **12-hour format with AM/PM**\n- **Custom greetings based on time of day**\n- **Multiple Wi-Fi credentials for reliable connection**\n\n![lcd2](https://github.com/user-attachments/assets/0217db36-2466-49df-b1bf-2aa55778d2b4)\n![lcd](https://github.com/user-attachments/assets/1a481b98-79e7-4f9b-aa1b-20703cc2c927)\n\u003cimg width=\"2490\" height=\"1650\" alt=\"circuit-diagram (9)\" src=\"https://github.com/user-attachments/assets/649b6509-bbd8-421f-87d2-976b3dc93f21\" /\u003e\n\n\n\n---\n\n## ✨ Features\n- Large custom-digit display using LCD’s CGRAM.\n- Time updates from NTP every minute.\n- Greets user with:\n  - `Good Morning` (6 AM to 12 PM)\n  - `Good Afternoon` (12 PM to 10 PM)\n  - `Good Night` (10 PM to 6 AM)\n- Multiple stored Wi-Fi credentials — automatically connects to first available.\n- Neatly arranged clock layout so AM/PM fits perfectly.\n\n---\n\n## 🛠 Hardware Required\n- **ESP8266 NodeMCU**\n- **I2C LCD Display** (20x4 recommended)\n- USB cable \u0026 power supply\n- Internet access\n\n---\n\n## 📦 Libraries Required\nInstall these libraries via Arduino IDE’s **Library Manager**:\n- `ESP8266WiFi.h`\n- `NTPClient.h`\n- `WiFiUdp.h`\n- `Wire.h`\n- `LiquidCrystal_I2C.h`\n\n---\n\n## ⚡ How It Works\n1. ESP8266 tries to connect to one of the stored Wi-Fi credentials.\n2. Fetches time from NTP server (`pool.ntp.org`) with India time offset.\n3. Displays the time in big digits on the LCD.\n4. Shows a greeting message based on the hour of the day.\n5. Refreshes every second for real-time updates.\n\n---\n\n## 🔧 Setup\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/MaxonXOXO/CustomLCD.git\n   ```\n2. Open the `.ino` file in Arduino IDE.\n3. Replace Wi-Fi credentials in the code:\n   ```cpp\n   #define WIFI_SSID_1 \"YourFirstSSID\"\n   #define WIFI_PASSWORD_1 \"YourFirstPassword\"\n   ```\n4. Upload the code to your ESP8266.\n5. Connect your I2C LCD to the correct pins and power up.\n\n---\n\n## 📷 Example Output\n```\nGood Morning\n 08:45 AM\n```\n\n---\n\n## 📜 License\nThis project is licensed under the MIT License — feel free to modify and share. \n\n---\n\n**Made with ❤️ by MAXONXOXO**!\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxonxoxo%2Fcustomlcd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxonxoxo%2Fcustomlcd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxonxoxo%2Fcustomlcd/lists"}