/little-sky

Primary LanguageJavaMIT LicenseMIT

LittleSky

This is a clock application in Java.

The original idea is made by zk-phi.

img

Installation

You can get a jar file from release pages.

Environment

OS

  • Windows
    • I confirmed to run in Windows 10.
  • Mac
    • I can't confirm in Mac because I don't have it.
    • If this application can't run in Mac, please pull request.

JRE

Java 8u40 or later.

Starting

$ java -jar littlesky.jar

This application save configurations to a file (littkesky.xml).
The file is saved at the current directory.

If you move the jar file, you must move the littlesky.xml too.

Setup at the first time

setup

At the first time, you must set your location.

The location setting is used at calculating sunset/surise times and requesting weather informations.

How to use

main-window

The main window has three elements.

  1. Sky Icon
    • This element displays the moon phase if weather is sunny.
    • Or else, rainy or snowy icon is shown.
  2. Time
    • Current time.
  3. Temperature
    • Current temperature.
    • Temperature is displayed as color.
    • blue (colder), white (normal), red (hotter)

Context menu

context-menu

The context menu is shown if you click the time label on mouse right button.

Weather service

This application uses the OpenWeatherMap to get weather informations.

Get API Key

Please get API Key of the OpenWeatherMap.

You need to sign up the OpenWeatherMap to get API Key.

Set API Key

api-key

Select Options at the context menu, setting dialog is shown.

Please set the API Key, and save it.

Enable weather service

weather-service

Select [Weather service] > [Start] at the context menu.
Weather service is started.

At next start time, weather service is started automatically, if API Key is set.

If you want to stop weather service, select [Weather service] > [Stop] on the context menu.

HTTP Proxy

proxy

You can set settings of http proxy at Options dialog.

If you don't set port, 80 is used at default.

If the http proxy requires authentications, you must set User and Password

Note: Password is saved in plain text at the configuration file(littlesky.xml).

View

view

Select [View] at the context menu.

Always on top

If you check this menu, window is always shown on most top of the desktop.

Default is false.

Show seconds

You can show or hide the seconds at time label.

Default is true.

Show temperature

You can show or hide the temperature element.

Default is true.

Show sky status icon

You can show or hide the sky status icon.

Default is true.

OSS

This application uses some OSS.

Release Notes

  • v1.1.0
    • Support task tray #1
    • Synchronize task bar icon and sky icon #2
  • v1.0.0
    • First Release