Download Latest Version simplest-manual-counter_v1.1.0_lin.zip (12.9 MB)
Email in envelope

Get an email when there's a new version of The Simplest Manual Counter

Home / 1.0.6
Name Modified Size InfoDownloads / Week
Parent folder
package 2014-03-10
0
install 2013-01-02
0
src 2013-01-02
0
img 2013-01-02
0
bin 2013-01-02
0
README.txt 2013-01-02 7.1 kB
0
LISEZ-MOI.txt 2013-01-02 7.6 kB
0
COPYING.txt 2013-01-02 32.5 kB
0
counter_example.csv 2013-01-02 42 Bytes
0
Totals: 9 Items   47.3 kB 0 
README file of Easycounter project v1.0.6 (http://easycounter.sourceforge.net)

  I) Description

    Easycounter is an open source manual counter offering the easiest counting with your keyboard.
    Each counter refers to a name and a key (a letter or a number) you configurate at its creation for identifying and increasing/decreasing it.
    Since v1.0.5, counters are grouped together in workspace for more convenience.
		
  II) 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 : easycounter
      Download the last zipped package (http://sourceforge.net/projects/easycounter/files/latest) 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.
        -> 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 II- 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 at:
          http://strawberryperl.com/

      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) or use your system package manager (like rpm -i Perl, dbm).

      For more details about Perl, visit http://www.perl.org/about.html .

    - Step III : the Perl/Tk module
      This module is necessary for windowing the script.
      a) on all platforms
        All the installing scripts are in the sub-directory "install".
        You can even run hasPerl_[win or lin] as above or directly the appropriate script "hasPerlTk" with "_win.cmd" extension for Windows, or "_lin.sh" for Linux.
        -> If it prompts the following message "Perl Tk is NOT INSTALLED!", continue on b) or c).

      b) on Windows
        Run install_PerlTk_win.cmd
        Once the Perl/Tk module installed, you'll have the following message "Installation of Perl/Tk SUCCESSFUL!" and a prompt inviting you to press any key to see a graphical interface...

      c) on Linux
        Run install_PerlTk_lin.sh
        Once the Perl/Tk module installed, you'll have the following message "Installation of Perl/Tk SUCCESSFUL!" and a prompt inviting you to press any key to see a graphical interface...


      Congratulation! The Perl engine and Tk module are installed. Then, you can use the counter!


  III) User Guide
		
    1) "How to"
      
        Run easycounter on Windows 32 bits
    Find the binary easycounter_w32.exe in the directory "bin" with a file system explorer, and double clic on it. It shall open a black window displaying license terms of using, and thereafter the counter itself.
    
        Run source code of easycounter on all platforms
    Find the script easycounter.pl in the directory "src" with a file system explorer, and double clic on it. It shall open a black window displaying license terms of using, and thereafter the counter itself.

        Create counters and use them
    Write the name of the counter in the "name" entry zone, and the associated key (usually a letter) in "key" zone. 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.
    or
    - Write the file name in "file" entry zone, and press "Enter" key.

        Open a new workspace
    Clic on the "+" tab. All workspaces are independant: saving, increasing, etc... counters of one of them doesn't interfere with the others.
		
        Increment any counters
    Each time you press a configurated key, its associated counter increments.

        Decrement any counters
    Each time you press the "Alt" key continuously and a configurated key, its associated counter decrements.

        Undo a count
    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 or Ctrl+s saves the counters of the active workspace in a file with ".csv" extension. Then it can be opened later with a spreadsheet.

        Add counters
    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.

    
    2) Hints
    
    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").
		
    The "Ctrl+T" keys combination adds a new workspace for working on others counters. The other workspaces are kept pending.
		
    The "Ctrl+S" keys combination saves the counters of the active workspace in a file with ".csv" extension.
		
    The "Ctrl+W" keys combination asks for saving counters if necessary before closing the active workspace.
		
    The "Ctrl+Q" keys combination asks for saving the counters of all workspaces if necessary before quitting.
    
    
  IV) Contact and Support

    For different kind of request, here are usefull links to sourceforge services:
    -> submiting an idea for improvement : https://sourceforge.net/tracker/?group_id=306325&atid=1290646
    -> get support : https://sourceforge.net/tracker/?group_id=306325&atid=1290644
    -> reporting bugs : https://sourceforge.net/tracker/?group_id=306325&atid=1290643
    -> direct contact : david.balogh at free.fr

    In any case, I'll try to satisfy you the best possible.

  V) License
    Easycounter is distributed under the GNU General Public License (see COPYING.txt file or http://www.gnu.org/licenses/).

Copyright David BALOGH (david.balogh at free.fr).
Source: README.txt, updated 2013-01-02