klokk - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #typescript #android #machine-learning #macos #java #windows #kubernetes #pytorch #security #mcp #openai

klokk

(★ 389)

🕒 A kinetic wall clock, built using Compose Multiplatform

파일 탐색기

최종 버전 다운로드 (.zip)

- - release.yml
- RELEASE_SETUP.md
- - Project_Default.xml
- .gitignore
- compiler.xml
- jarRepositories.xml
- misc.xml
- runConfigurations.xml
- vcs.xml
- build.gradle.kts
- build.gradle.kts
- - 2021-03-21_04-11.png
  - 2021-03-21_04-13.png
  - 2021-03-21_04-40.png
- - 2021-03-22_00-08.png
  - 2021-03-22_00-09.png
  - 2021-03-22_00-09_1.png
- - close.png
  - open.png
- klokk-alphabets
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- build.gradle.kts
.gitignore
build.gradle.kts
cover.jpeg
demo.gif
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
screenshot.png
settings.gradle.kts

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/theapache64/klokk

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd klokk

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

./gradlew :app:installDebug

Gradle로 빌드를 진행합니다.

./gradlew :app:assembleDebug

Gradle로 빌드를 진행합니다.

./gradlew :desktopApp:run

Gradle로 빌드를 진행합니다.

./gradlew :desktopApp:packageDmg # macOS

Gradle로 빌드를 진행합니다.

./gradlew :desktopApp:packageMsi # Windows

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🕒 klokk

![buildStatus](https://img.shields.io/github/workflow/status/theapache64/kinetic-wall-clock/Java%20CI%20with%20Gradle?style=plastic)
![latestVersion](https://img.shields.io/github/v/release/theapache64/kinetic-wall-clock)
<a href="https://twitter.com/theapache64" target="_blank">
<img alt="Twitter: theapache64" src="https://img.shields.io/twitter/follow/theapache64.svg?style=social" />
</a>

![](https://raw.githubusercontent.com/theapache64/klokk/master/screenshot.png)

> A kinetic wall clock, built using Compose Multiplatform. Available on Android, Android TV, and Desktop (Windows, macOS, Linux).

## 📦 Download

Download the latest release for your platform from the [**Releases**](../../releases) page:

- **Android Mobile** - APK file
- **Android TV** - Same APK, optimized for TV experience
- **Windows** - MSI installer
- **macOS** - DMG package
- **Linux** - DEB package

## 🔮 Demo

![](https://raw.githubusercontent.com/theapache64/klokk/master/demo.gif)

- [Watch](https://youtu.be/ECNfa3L4U6s) full demo
- [Watch](https://www.youtube.com/watch?v=lTsZOs_PkbM) Development - Behind the Scenes - Part 1
- [Watch](https://www.youtube.com/watch?v=ejp9850FWy8) Development - Behind the Scenes - Part 2

## 🏃‍♂️ Build & Run

### Android
```bash
# Install on connected device
./gradlew :app:installDebug

# Or build APK
./gradlew :app:assembleDebug
# APK location: app/build/outputs/apk/debug/app-debug.apk
```

### Desktop
```bash
# Run directly
./gradlew :desktopApp:run

# Create installer packages
./gradlew :desktopApp:packageDmg      # macOS
./gradlew :desktopApp:packageMsi      # Windows
./gradlew :desktopApp:packageDeb      # Linux
```

## ✨ Platform Features

| Feature | Android Mobile | Android TV | Desktop |
|---------|---------------|------------|---------|
| Immersive Mode | ✅ | ✅ | ➖ |
| D-pad Navigation | ➖ | ✅ | ➖ |
| Touch Controls | ✅ | ➖ | ➖ |
| Mouse/Keyboard | ➖ | ➖ | ✅ |
| Landscape Lock | ✅ | ✅ (default) | ➖ |
| Screen Always On | ✅ | ✅ | ✅ |

## 💡 Inspiration

- Nezih Yılmaz's kinetic countdown timer
- A million times humans since 1982

## ✍️ Author

👤 **theapache64**

* Twitter: <a href="https://twitter.com/theapache64" target="_blank">@theapache64</a>
* Email: theapache64@gmail.com

Feel free to ping me 😉

## 🚀 Creating Releases

This project uses GitHub Actions to automatically build and release packages for all platforms.

### How to Create a Release:

1. Update version in `app/build.gradle.kts`
2. Commit your changes: `git commit -m "Release v1.0.2"`
3. Create and push a tag: `git tag v1.0.2 && git push origin v1.0.2`
4. GitHub Actions will automatically build and create a release

See [`.github/RELEASE_SETUP.md`](.github/RELEASE_SETUP.md) for detailed setup instructions.

## 🤝 Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any
contributions you make are **greatly appreciated**.

1. Open an issue first to discuss what you would like to change.
1. Fork the Project
1. Create your feature branch (`git checkout -b feature/amazing-feature`)
1. Commit your changes (`git commit -m 'Add some amazing feature'`)
1. Push to the branch (`git push origin feature/amazing-feature`)
1. Open a pull request

Please make sure to update tests as appropriate.

## ❤ Show your support

Give a ⭐️ if this project helped you!

<a href="https://www.patreon.com/theapache64">
  <img alt="Patron Link" src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160"/>
</a>

<a href="https://www.buymeacoffee.com/theapache64" target="_blank">
    <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="160">
</a>

<a href="https://www.paypal.me/theapache64" target="_blank">
    <img src="https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif" alt="Donation" width="160">
</a>

## ☑️ TODO

- [ ] Dark Theme Support
- [ ] Wave Movement
- [ ] Tornado Movement
- [ ] Background Music
- [x] Add second movement to border clocks
- [ ] Add alphabets

## 📝 License

```
Copyright © 2021 - theapache64

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

_This README was generated by [readgen](https://github.com/theapache64/readgen)_ ❤