{"id":15040875,"url":"https://github.com/jumman04/analogue-watch","last_synced_at":"2025-04-14T19:33:35.909Z","repository":{"id":240275874,"uuid":"802152188","full_name":"Jumman04/Analogue-Watch","owner":"Jumman04","description":"Analog Clock Library is a customizable Android library that displays time in a traditional analog format. Easily integrate a stylish analog clock into your app with adjustable colors, markers, hand styles, ticking sound effects, and more.","archived":false,"fork":false,"pushed_at":"2025-04-13T10:32:03.000Z","size":718,"stargazers_count":19,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-13T11:33:48.130Z","etag":null,"topics":["analog-clock","android","android-development","android-library","clock-widget","custom-view","customizable","customizable-ui","java","kotlin","library","open-source","time-display","ui-component","ui-design"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jumman04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2024-05-17T16:08:00.000Z","updated_at":"2025-04-13T10:32:07.000Z","dependencies_parsed_at":"2024-05-20T19:38:21.724Z","dependency_job_id":"abc2a767-9be3-456c-91c1-2df559b5c594","html_url":"https://github.com/Jumman04/Analogue-Watch","commit_stats":null,"previous_names":["jumman04/analogue-watch"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jumman04%2FAnalogue-Watch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jumman04%2FAnalogue-Watch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jumman04%2FAnalogue-Watch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jumman04%2FAnalogue-Watch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jumman04","download_url":"https://codeload.github.com/Jumman04/Analogue-Watch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248946302,"owners_count":21187485,"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":["analog-clock","android","android-development","android-library","clock-widget","custom-view","customizable","customizable-ui","java","kotlin","library","open-source","time-display","ui-component","ui-design"],"created_at":"2024-09-24T20:45:13.273Z","updated_at":"2025-04-14T19:33:35.879Z","avatar_url":"https://github.com/Jumman04.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n   \u003cimg src=\"https://github.com/Jumman04/Analogue-Watch/assets/113237846/1efff827-143a-49b2-988c-4b059ac0d7fa\" alt=\"App Icon\" width=\"222\"\u003e\n   \u003cbr\u003e\n   \u003cimg src=\"https://img.shields.io/badge/API-17%2B-brightgreen.svg?style=flat\" alt=\"API Level 17 and above\"/\u003e\n   \u003ca href=\"https://jitpack.io/#Jumman04/Analogue-Watch\"\u003e\n   \u003cimg src=\"https://jitpack.io/v/Jumman04/Analogue-Watch.svg\" alt=\"JitPack Version\"/\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://github.com/Jumman04/Analogue-Watch/network/members\"\u003e\n   \u003cimg src=\"https://img.shields.io/github/forks/Jumman04/Analogue-Watch\" alt=\"GitHub Forks\"/\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://github.com/Jumman04/Analogue-Watch/stargazers\"\u003e\n   \u003cimg src=\"https://img.shields.io/github/stars/Jumman04/Analogue-Watch\" alt=\"GitHub Stars\"/\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://github.com/Jumman04/Analogue-Watch/blob/master/LICENSE.md\"\u003e\n   \u003cimg src=\"https://img.shields.io/github/license/Jumman04/Analogue-Watch\" alt=\"GitHub License\"/\u003e\n   \u003c/a\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eAnalog Clock Library\u003c/h1\u003e\n\n\nAnalog Clock Library is a customizable Android library for displaying time in a traditional analog\nformat. It provides developers with a range of customization options to adjust various aspects such\nas hour markers, minute markers, hour indicator text, and clock hands (hour, minute, second) to suit\ntheir application's design.\n\n---\n\n## Features\n\n- Display time in a traditional analog format\n- Customize background color, marker colors, and hand colors\n- Adjust heights and widths of minute markers, hour markers, and hands\n- Enable/disable minute markers, hour markers, and hour indicator text\n- Ticking sound effects with adjustable volume\n- Customize text size, font family, text color, and text style for hour indicator text\n\n---\n\n### Installation\n\nAdd JitPack repository to your root build.gradle file:\nAdd it in your root build.gradle at the end of repositories:\n\n```groovy\nallprojects {\n    repositories {\n        // Other repositories...\n        maven { url 'https://jitpack.io' }\n    }\n}\n```\n\nStep 2. Add the dependency\n\n```groovy\n    dependencies {\n    implementation 'com.github.Jumman04:Analogue-Watch:4.2'\n}\n```\n\n---\n\n## Usage in XML Layouts\n\n```xml\n\n\u003ccom.jummania.AnalogClock \n    android:layout_width=\"match_parent\"\n    android:layout_height=\"match_parent\" /\u003e\n```\n\n## Usage in Programmatic\n\n```java\nAnalogClock analogClock = new AnalogClock(this);\n```\n\n---\n\n## Customization Attributes\n\nCustomize the appearance of the `AnalogClock` view by using the following XML attributes:\n\n### Color Attributes\n\n- `background_color`: Background color of the clock face\n- `minute_marker_color`: Color of minute markers\n- `hour_marker_color`: Color of hour markers\n- `second_hand_color`: Color of the second hand\n- `minute_hand_color`: Color of the minute hand\n- `hour_hand_color`: Color of the hour hand\n- `textColor`: Text color for hour indicator text\n\n### Dimension Attributes\n\n- `minute_marker_height`: Height of minute markers\n- `hour_marker_height`: Height of hour markers\n- `textSize`: Text size for hour indicator text\n\n### Boolean Attributes\n\n- `minute_marker`: Enable/disable display of minute markers\n- `hour_marker`: Enable/disable display of hour markers\n- `enable_sound`: Enable/disable ticking sound effects\n- `enable_hour_text`: Enable/disable display of hour indicator text\n\n### Text Attributes\n\n- `fontFamily`: Font family for hour indicator text\n\n---\n\n## Example XML usage with attributes:\n\n```xml\n\n\u003ccom.jummania.AnalogClock \n    android:layout_width=\"match_parent\" \n    android:layout_height=\"match_parent\"\n    app:background_color=\"@color/white\" \n    app:minute_marker_color=\"@color/gray\"\n    app:hour_marker_color=\"@color/black\"\n    app:textColor=\"@color/black\"\n    app:second_hand_color=\"@color/red\"\n    app:minute_hand_color=\"@color/blue\" \n    app:hour_hand_color=\"@color/green\"\n\n    app:minute_marker_height=\"0.1\" \n    app:hour_marker_height=\"0.15\" \n    app:second_hand_height=\"0.9\"\n    app:minute_hand_height=\"0.8\"\n    app:hour_hand_height=\"0.7\"\n    app:second_hand_width=\"0.02\"\n    app:minute_hand_width=\"0.03\"\n    app:hour_hand_width=\"0.04\"\n    \n    app:minute_marker=\"true\" \n    app:hour_marker=\"true\"\n    app:enable_hour_text=\"true\"\n    app:enable_second_hand=\"true\"\n    app:enable_minute_hand=\"true\"\n    app:enable_hour_hand=\"true\"\n    app:enable_sound=\"true\"\n\n    app:volume=\"0.5\"\n    app:clock_sound=\"@raw/ticking_sound\"\n    app:textSize=\"14sp\"\n    app:fontFamily=\"sans-serif\" \n    app:textStyle=\"normal\"\n/\u003e\n\n\n```\n\n## Programmatic Customization\n\nYou can also customize the AnalogClock view programmatically:\n\n```kt\nanalogClock.setBackgroundColor(Color.WHITE)\nanalogClock.setMarkerColor(minuteMarkerColor = Color.GRAY, hourMarkerColor = Color.BLACK)\nanalogClock.setHandColor(secondHandColor = Color.RED, minuteHandColor = Color.BLUE, hourHandColor = Color.GREEN)\nanalogClock.setTextColor(Color.BLACK)\n\nanalogClock.setMarkerHeight(minuteMarkerHeight = 0.1f, hourMarkerHeight = 0.15f)\nanalogClock.setHandHeight(secondHandHeight = 0.8f, minuteHandHeight = 0.7f, hourHandHeight = 0.6f)\nanalogClock.setHandWidth(secondHandWidth = 0.02f, minuteHandWidth = 0.03f, hourHandWidth = 0.04f)\nanalogClock.setTextSize(14f)\n\nanalogClock.enableHourText(true)\nanalogClock.enableSound(true)\nanalogClock.enableMarkers(minuteMarker = true, hourMarker = true)\nanalogClock.enableHands(secondHand = true, minuteHand = true, hourHand = true)\n\nanalogClock.setVolume(0.5f)\nanalogClock.setMediaPlayer(R.raw.clock_tick)\n\nanalogClock.setTypeface(Typeface.SANS_SERIF)\n\n\n```\n\n## Feature Requests\n\nIf you have a feature request or a suggestion for improving this library, please feel free\nto [open an issue](https://github.com/Jumman04/Analogue-Watch/issues/new) and let us know! We\nappreciate your feedback and are always looking to make our library better.\n\n#### How to Request a Feature\n\n1. Click on the [Issues tab](https://github.com/Jumman04/Analogue-Watch/issues).\n2. Click the green \"New Issue\" button.\n3. Fill in the requested information and submit the issue.\n\n# Thank you for using and contributing to the improvement of our library!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjumman04%2Fanalogue-watch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjumman04%2Fanalogue-watch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjumman04%2Fanalogue-watch/lists"}