Kronometer: Difference between revisions

From KDE UserBase Wiki
mNo edit summary
(Formatting changes, splitting lists, prepared for translation)
Line 1: Line 1:
<languages />
<translate>
[[File:Kronometer.png]]
[[File:Kronometer.png]]


=== Description ===
=== Description ===


Kronometer is a stopwatch application. Kronometer is free software and it's released under the [https://www.gnu.org/licenses/gpl-2.0.html GPLv2] license.
'''Kronometer''' is a stopwatch application. '''Kronometer''' is free software and it's released under the [https://www.gnu.org/licenses/gpl-2.0.html GPLv2] license.


Kronometer's main features are the following:
'''Kronometer's''' main features are the following:


* Start/pause/resume the stopwatch widget
* Start/pause/resume the stopwatch widget</translate>
* Laps recording: you can capture the stopwatch time when you want and add a note to it
<translate>
* Lap times sorting: you can easily find the shortest lap time or the longest one
* Laps recording: you can capture the stopwatch time when you want and add a note to it</translate>
* Reset the stopwatch widget and the lap times
<translate>
* Time format settings: you can choose the stopwatch granularity
* Lap times sorting: you can easily find the shortest lap time or the longest one</translate>
* Times saving and resuming: you can save the stopwatch status and resume it later
<translate>
* Font customization: you can choose the fonts for each of the stopwatch digits
* Reset the stopwatch widget and the lap times</translate>
* Color customization: you can choose the color for the stopwatch digits and the stopwatch background
<translate>
* Time format settings: you can choose the stopwatch granularity</translate>
<translate>
* Times saving and resuming: you can save the stopwatch status and resume it later</translate>
<translate>
* Font customization: you can choose the fonts for each of the stopwatch digits</translate>
<translate>
* Color customization: you can choose the color for the stopwatch digits and the stopwatch background</translate>
<translate>
* Lap times export: you can export the lap times on a file using the JSON or CSV format
* Lap times export: you can export the lap times on a file using the JSON or CSV format


=== Download ===
=== Download ===


* Kronometer latest version: <tt>2.2.1</tt>
* Kronometer latest version: <tt>2.2.1</tt></translate>
* Source code: [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz kronometer-2.2.1.tar.xz]
<translate>
* SHA256: go to the [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz.mirrorlist mirrors page]
* Source code: [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz kronometer-2.2.1.tar.xz]</translate>
<translate>
* SHA256: go to the [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz.mirrorlist mirrors page]</translate>
<translate>
* Mirrors: go to the [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz.mirrorlist mirrors page]
* Mirrors: go to the [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz.mirrorlist mirrors page]


Line 41: Line 54:
==== Debian ====
==== Debian ====


Kronometer is currently packaged for Debian Sid:
'''Kronometer''' is currently packaged for Debian Sid:


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Line 79: Line 92:
The following installation instructions are ''distro-agnostic'', i.e. they should work on all the Linux distributions.
The following installation instructions are ''distro-agnostic'', i.e. they should work on all the Linux distributions.


# Download the latest source files archive from the link above
# Download the latest source files archive from the link above</translate>
# Extract the archive in your preferred directory
<translate>
# Extract the archive in your preferred directory</translate>
<translate>
# Open a terminal in that directory and run the following commands:
# Open a terminal in that directory and run the following commands:


Line 94: Line 109:
Software dependencies:
Software dependencies:


* Qt 5.0.0 or above, only the following modules:
* Qt 5.0.0 or above, only the following modules:</translate>
** QtCore
<translate>
** QtGui
** QtCore</translate>
** QtWidget
<translate>
* KDE Frameworks 5.15.0 or above, only the following modules:
** QtGui</translate>
** KF5Config
<translate>
** KF5DocTools
** QtWidget</translate>
** KF5I18n
<translate>
** KF5WidgetsAddons
* KDE Frameworks 5.15.0 or above, only the following modules:</translate>
** KF5XmlGui
<translate>
* CMake 3.1 or above
** KF5Config</translate>
* Extra CMake Modules 1.6.0 or above
<translate>
** KF5DocTools</translate>
<translate>
** KF5I18n</translate>
<translate>
** KF5WidgetsAddons</translate>
<translate>
** KF5XmlGui</translate>
<translate>
* CMake 3.1 or above</translate>
<translate>
* Extra CMake Modules 1.6.0 or above</translate>
<translate>
* GCC or Clang.
* GCC or Clang.


Line 118: Line 145:
=== Documentation ===
=== Documentation ===


Kronometer provides a KDE-compliant documentation, which is available within the installed application by clicking <code>Kronometer Handbook</code> under the <code>Help</code> menu. The documentation is also available online on the KDE servers:
'''Kronometer''' provides a KDE-compliant documentation, which is available within the installed application by clicking <menuchoice>Kronometer Handbook</menuchoice> under the <menuchoice>Help</menuchoice> menu. The documentation is also available online on the KDE servers:


* Kronometer Handbook ([https://docs.kde.org/stable5/en/extragear-utils/kronometer/index.html HTML])
* Kronometer Handbook ([https://docs.kde.org/stable5/en/extragear-utils/kronometer/index.html HTML])</translate>
<translate>
* Kronometer Handbook ([https://docs.kde.org/stable5/en/extragear-utils/kronometer/kronometer.pdf PDF])
* Kronometer Handbook ([https://docs.kde.org/stable5/en/extragear-utils/kronometer/kronometer.pdf PDF])


=== Contribute ===
=== Contribute ===


Kronometer is part of the KDE community. If you want to contribute to the Kronometer development, you are encouraged to join the KDE world. Check out [https://community.kde.org/Get_Involved this page.] The <tt>git</tt> repository is located [https://commits.kde.org/kronometer here].
'''Kronometer''' is part of the KDE community. If you want to contribute to the '''Kronometer''' development, you are encouraged to join the KDE world. Check out [https://community.kde.org/Get_Involved this page.] The <tt>git</tt> repository is located [https://commits.kde.org/kronometer here].


=== Doxygen ===
=== Doxygen ===
Line 133: Line 161:


[[Category:Utilities]]
[[Category:Utilities]]
</translate>

Revision as of 10:12, 25 February 2018

Other languages:

Description

Kronometer is a stopwatch application. Kronometer is free software and it's released under the GPLv2 license.

Kronometer's main features are the following:

  • Start/pause/resume the stopwatch widget
  • Laps recording: you can capture the stopwatch time when you want and add a note to it
  • Lap times sorting: you can easily find the shortest lap time or the longest one
  • Reset the stopwatch widget and the lap times
  • Time format settings: you can choose the stopwatch granularity
  • Times saving and resuming: you can save the stopwatch status and resume it later
  • Font customization: you can choose the fonts for each of the stopwatch digits
  • Color customization: you can choose the color for the stopwatch digits and the stopwatch background
  • Lap times export: you can export the lap times on a file using the JSON or CSV format

Download


Older versions are available in the downloads page.

Installation

Arch Linux

Kronometer is available in the AUR:

git clone https://aur.archlinux.org/kronometer.git
cd kronometer
makepkg -sri

Debian

Kronometer is currently packaged for Debian Sid:

apt install kronometer

Gentoo

emerge x11-misc/kronometer

KaOS

kcp -i kronometer

NixOS

nix-env -iA kde5.kronometer

Flatpak

Only builds from git master are currently available.

flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak --user remote-add --if-not-exists kdeapps https://distribute.kde.org/kdeapps.flatpakrepo
flatpak --user install kdeapps org.kde.kronometer

Compile from sources

The following installation instructions are distro-agnostic, i.e. they should work on all the Linux distributions.

  1. Download the latest source files archive from the link above
  2. Extract the archive in your preferred directory
  3. Open a terminal in that directory and run the following commands:


mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=`qtpaths --install-prefix` ..
sudo make install

Now you should have Kronometer installed under /usr/bin and it should be available under the Utility entry in the Application Launcher of Plasma (or any other XDG-compliant menu).

Software dependencies:

  • Qt 5.0.0 or above, only the following modules:
    • QtCore
    • QtGui
    • QtWidget
  • KDE Frameworks 5.15.0 or above, only the following modules:
    • KF5Config
    • KF5DocTools
    • KF5I18n
    • KF5WidgetsAddons
    • KF5XmlGui
  • CMake 3.1 or above
  • Extra CMake Modules 1.6.0 or above
  • GCC or Clang.

Changelog

Go to the changelog page.

Bugs

Please use the official KDE Bugtracking system if you find a bug. You can also use it if you have a feature request.

Documentation

Kronometer provides a KDE-compliant documentation, which is available within the installed application by clicking Kronometer Handbook under the Help menu. The documentation is also available online on the KDE servers:

  • Kronometer Handbook (HTML)
  • Kronometer Handbook (PDF)

Contribute

Kronometer is part of the KDE community. If you want to contribute to the Kronometer development, you are encouraged to join the KDE world. Check out this page. The git repository is located here.

Doxygen

Doxygen documentation for the kronometer source code is available here.