Easycounter, the simplest manual counter
The installation and user guide chapters are both also in the README.txt file included in the easycounter*.zip package.
Easycounter is an open source manual counter offering the easiest counting with your keyboard.
As shown below in the screen view, easycounter is a single window application containing a few buttons for creating, opening and recording counters.
Each counter refers to a name and a key (a letter or a number) you configurate at its creation for identifying and incrementing/decrementing it.
Installation for executing source code only (optionnal on Windows 32 bits)
The installation follows three steps:
- the download/installation of easycounter in step I.
- the download/installation of the Perl engine in step II.
- and the download/installation of the Perl/Tk module in step III.
step I : the package "zip"
Download the last zipped package easycounter*.zip in your temporary directory.
Extract all its internal files in a new hosting directory (named «Easycounter» for example).
step II : the Perl engine
a) on all platforms
All the installing scripts are in the sub-directory «install».
Run the appropriate script «hasPerl» with «_win.cmd» extension for Windows, or «_lin.sh» for Linux OS).
→ If it prompts the following message «Perl engine is not installed», continue on b) or c).
→ If you have «Perl engine is already installed!», go straight to step III.
In both case, a message invites you to press any key to continue... Press a key, and that ends the hasPerl script.
- b) on Windows
In case the result of the previous a) step tells «Perl engine is NOT INSTALLED», install the engine accepting all the usual configuration parameters of this distribution:
Strawberry, the open source distribution of Perl for Microsoft Windows is available on:
- c) on Linux
In case the result of the previous a) step tells «Perl engine is NOT INSTALLED», get the installation package on perl.org site (http://www.perl.org/get.html) either use your system package manager (like rpm -i Perl).
step III : the Perl/Tk module
This module is necessary for windowing the script.
a) on Windows
Once the module Tk installed, you'll have the following message «Installation of Perl/Tk SUCCESFULL!» and a prompt inviting you to press any key to continue... Press a key, and that ends the script.
- b) on Linux
Once the module PerlTk installed, you'll have the following message «Installation of Perl/Tk SUCCESFULL!» and a prompt inviting you to press any key to continue... Press a key, and that ends the script.
Congratulation! The Perl engine and Tk module are installed. Now, you can use the counter.
The «tab» (|<--
-->|) key allows jumping between fields/buttons without the mouse.
The «Esc» key activates the keys (letters) for counting when the cursor is placed in a textual entry zone («name», «key», «file»).
Run easycounter on Windows 32 bits
Run easycounter on all platforms
Create counters and use them
Enter the name of your counters in the text entry zone and the associated key (usually a letter). Click «add» for each counters: they shall appear in the left frame.
Open existing counters
- Clic on «Browse», select the «csv» file wanted, and then clic on «open» button.
- Write the file name in «file» entry zone, and press «Enter» key.
Increment any counters
Every time you press a configurated key, it's associated counter will increment.
Decrement any counters
Each time you press the «Alt» key continuously and a configurated key, its associated counter decrements.
Undo counting (correcting it)
The left arrow can step backward for correcting ten increments maximum.
Redo counting (recuperating it)
The right arrow can step forward for cancelling ten undone increments maximum.
Save in a file
Click on «Save» button will save the counters in a file with «.csv» extension. Then it can be opened later with a spreadsheet.
It is possible to add counters whenever you want: after having opened a file, after having started counting. It keeps the existing previous counters.
Recuperate after crash
The counters are recorded in a temporary file (in %TEMP% or $TMP directories) every 20 seconds. In case of a crash of the program without saving, the running of it will propose you to open the temporary file.
In ordinary case, the temporary file is destroy after each stop of the program.
Since release 1.0.2, the script is written in object oriented syntax.
You shall find in starteasycounter.pl a commented block starting with «This is an example of using Easycounter class within a container :». It's a dozen of lines showing how to integrate easily the counter in an existing Perl/Tk window (widget).
Contact and Support
For different kind of request, here are usefull links to sourceforge services:
→ submiting an idea for improvement : Feature Requests
→ get support : Support Requests
→ reporting bugs : Bugs
→ direct contact : david.balogh at free.fr
In any case, I'll try to satisfy you the best possible.
Easycounter is distributed under the GNU General Public License.
This page is XHTML 1.0 Strict validated.