Kronometer: Difference between revisions

From KDE UserBase Wiki
(Formatting changes, splitting lists, prepared for translation)
(Marked this version for translation)
Line 1: Line 1:
<languages />
<languages />
<translate>
<translate>
<!--T:1-->
[[File:Kronometer.png]]
[[File:Kronometer.png]]


=== Description ===
=== Description === <!--T:2-->


<!--T:3-->
'''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.


<!--T:4-->
'''Kronometer's''' main features are the following:
'''Kronometer's''' main features are the following:


<!--T:5-->
* Start/pause/resume the stopwatch widget</translate>
* Start/pause/resume the stopwatch widget</translate>
<translate>
<translate>
<!--T:6-->
* Laps recording: you can capture the stopwatch time when you want and add a note to it</translate>
* Laps recording: you can capture the stopwatch time when you want and add a note to it</translate>
<translate>
<translate>
<!--T:7-->
* Lap times sorting: you can easily find the shortest lap time or the longest one</translate>
* Lap times sorting: you can easily find the shortest lap time or the longest one</translate>
<translate>
<translate>
<!--T:8-->
* Reset the stopwatch widget and the lap times</translate>
* Reset the stopwatch widget and the lap times</translate>
<translate>
<translate>
<!--T:9-->
* Time format settings: you can choose the stopwatch granularity</translate>
* Time format settings: you can choose the stopwatch granularity</translate>
<translate>
<translate>
<!--T:10-->
* Times saving and resuming: you can save the stopwatch status and resume it later</translate>
* Times saving and resuming: you can save the stopwatch status and resume it later</translate>
<translate>
<translate>
<!--T:11-->
* Font customization: you can choose the fonts for each of the stopwatch digits</translate>
* Font customization: you can choose the fonts for each of the stopwatch digits</translate>
<translate>
<translate>
<!--T:12-->
* Color customization: you can choose the color for the stopwatch digits and the stopwatch background</translate>
* Color customization: you can choose the color for the stopwatch digits and the stopwatch background</translate>
<translate>
<translate>
<!--T:13-->
* 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 === <!--T:14-->


<!--T:15-->
* Kronometer latest version: <tt>2.2.1</tt></translate>
* Kronometer latest version: <tt>2.2.1</tt></translate>
<translate>
<translate>
<!--T:16-->
* 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>
* 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>
<translate>
<!--T:17-->
* SHA256: go to the [http://download.kde.org/stable/kronometer/2.2.1/src/kronometer-2.2.1.tar.xz.mirrorlist mirrors page]</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>
<translate>
<!--T:18-->
* 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]




<!--T:19-->
Older versions are available in the [[Kronometer/Downloads|downloads page]].
Older versions are available in the [[Kronometer/Downloads|downloads page]].


=== Installation ===
=== Installation === <!--T:20-->


==== Arch Linux ====
==== Arch Linux ==== <!--T:21-->


<!--T:22-->
Kronometer is available in the AUR:
Kronometer is available in the AUR:


<!--T:23-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
git clone https://aur.archlinux.org/kronometer.git
git clone https://aur.archlinux.org/kronometer.git
Line 52: Line 71:
</syntaxhighlight>
</syntaxhighlight>


==== Debian ====
==== Debian ==== <!--T:24-->


<!--T:25-->
'''Kronometer''' is currently packaged for Debian Sid:
'''Kronometer''' is currently packaged for Debian Sid:


<!--T:26-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
apt install kronometer
apt install kronometer
</syntaxhighlight>
</syntaxhighlight>


==== Gentoo ====
==== Gentoo ==== <!--T:27-->


<!--T:28-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
emerge x11-misc/kronometer
emerge x11-misc/kronometer
</syntaxhighlight>
</syntaxhighlight>


==== KaOS ====
==== KaOS ==== <!--T:29-->


<!--T:30-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
kcp -i kronometer
kcp -i kronometer
</syntaxhighlight>
</syntaxhighlight>


==== NixOS ====
==== NixOS ==== <!--T:31-->


<!--T:32-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
nix-env -iA kde5.kronometer
nix-env -iA kde5.kronometer
</syntaxhighlight>
</syntaxhighlight>


==== Flatpak ====
==== Flatpak ==== <!--T:33-->


<!--T:34-->
Only builds from git master are currently available.
Only builds from git master are currently available.


<!--T:35-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
Line 88: Line 114:
</syntaxhighlight>
</syntaxhighlight>


==== Compile from sources ====
==== Compile from sources ==== <!--T:36-->


<!--T:37-->
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.


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




<!--T:41-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
mkdir build && cd build
mkdir build && cd build
Line 105: Line 136:
</syntaxhighlight>
</syntaxhighlight>


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


<!--T:43-->
Software dependencies:
Software dependencies:


<!--T:44-->
* Qt 5.0.0 or above, only the following modules:</translate>
* Qt 5.0.0 or above, only the following modules:</translate>
<translate>
<translate>
<!--T:45-->
** QtCore</translate>
** QtCore</translate>
<translate>
<translate>
<!--T:46-->
** QtGui</translate>
** QtGui</translate>
<translate>
<translate>
<!--T:47-->
** QtWidget</translate>
** QtWidget</translate>
<translate>
<translate>
<!--T:48-->
* KDE Frameworks 5.15.0 or above, only the following modules:</translate>
* KDE Frameworks 5.15.0 or above, only the following modules:</translate>
<translate>
<translate>
<!--T:49-->
** KF5Config</translate>
** KF5Config</translate>
<translate>
<translate>
<!--T:50-->
** KF5DocTools</translate>
** KF5DocTools</translate>
<translate>
<translate>
<!--T:51-->
** KF5I18n</translate>
** KF5I18n</translate>
<translate>
<translate>
<!--T:52-->
** KF5WidgetsAddons</translate>
** KF5WidgetsAddons</translate>
<translate>
<translate>
<!--T:53-->
** KF5XmlGui</translate>
** KF5XmlGui</translate>
<translate>
<translate>
<!--T:54-->
* CMake 3.1 or above</translate>
* CMake 3.1 or above</translate>
<translate>
<translate>
<!--T:55-->
* Extra CMake Modules 1.6.0 or above</translate>
* Extra CMake Modules 1.6.0 or above</translate>
<translate>
<translate>
<!--T:56-->
* GCC or Clang.
* GCC or Clang.


=== Changelog ===
=== Changelog === <!--T:57-->


<!--T:58-->
Go to the [[Kronometer/Changelog|changelog page]].
Go to the [[Kronometer/Changelog|changelog page]].


=== Bugs ===
=== Bugs === <!--T:59-->


<!--T:60-->
Please use the official [https://bugs.kde.org/ KDE Bugtracking system] if you find a bug. You can also use it if you have a feature request.
Please use the official [https://bugs.kde.org/ KDE Bugtracking system] if you find a bug. You can also use it if you have a feature request.


=== Documentation ===
=== Documentation === <!--T:61-->


<!--T:62-->
'''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''' 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:


<!--T:63-->
* Kronometer Handbook ([https://docs.kde.org/stable5/en/extragear-utils/kronometer/index.html HTML])</translate>
* Kronometer Handbook ([https://docs.kde.org/stable5/en/extragear-utils/kronometer/index.html HTML])</translate>
<translate>
<translate>
<!--T:64-->
* 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 === <!--T:65-->


<!--T:66-->
'''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 === <!--T:67-->


<!--T:68-->
[http://doxygen.org Doxygen] documentation for the kronometer source code is available [http://api.kde.org/extragear-api/utils-apidocs/kronometer/src/html/index.html here].
[http://doxygen.org Doxygen] documentation for the kronometer source code is available [http://api.kde.org/extragear-api/utils-apidocs/kronometer/src/html/index.html here].




<!--T:69-->
[[Category:Utilities]]
[[Category:Utilities]]
</translate>
</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.