Login | ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
Revision: 97
Committed: Mon Oct 25 15:23:58 2021 UTC (8 months, 1 week ago) by daniel-marschall
Content type: text/markdown
File size: 2853 byte(s)
Log Message:
Added README.md for UserDetect2

File Contents

# User Rev Content
1 daniel-marschall 97 # ViaThinkSoft UserDetect2
3     ## What is UserDetect2?
5     UserDetect2 is a program that allows the user to execute different programs depending on their current environment (e.g. MAC addresses, user name or computer name), so that a single executable file, e.g. shared over a network drive, a flash drive or external hard disk, can perform tasks for different work stations. The environment identifications can be extended by plugins.
7     ## Usage example
9     You have an external hard disk which you use for a daily backup with a backup tool (e.g. Microsoft RoboCopy).
11     You use this external drive to perform backups for different computers.
13     Additionally, you want to decide if the computer should be shutdown after the backup, or not. (Can be useful if you leave the computer alone, while the backup is performing)
15     If you have 2 computers with the names “JohnPC” and “JohnLaptop”, then you would probably need 4 batch files:
17     1. E:\JohnPC\backup_no_shutdown.bat
18     2. E:\JohnPC\backup_shutdown.bat
19     3. E:\JohnLaptop\backup_no_shutdown.bat
20     4. E:\JohnLaptop\backup_shutdown.bat
22     If you accidently start the wrong batch file, the backups will be inconsistent, and there may be data loss.
24     But if you use UserDetect2, you could create following Task Definition File:
26     [NoShutdown]
27     Description=Run backup without shutdown
28     ComputerName:JohnPC=JohnPC\backup_no_shutdown.bat
29     ComputerName:JohnLaptop=JohnLaptop\backup_no_shutdown.bat
31     [Shutdown]
32     Description=Run backup and shutdown
33     ComputerName:JohnPC=JohnPC\backup_shutdown.bat
34     ComputerName:JohnLaptop=JohnLaptop\backup_shutdown.bat
36     In this case, you would only need to run “E:\UserDetect2.exe” (maybe even use it as AutoRun application, if you are working with Windows Vista or previous versions of Windows) and then select if you want to perform a backup with or without shutdown. UserDetect2 will select the correct batch file for you.
38     ## Documentation
40     In the [documentation](https://github.com/danielmarschall/userdetect2/blob/master/UserDetect2/Documentation.pdf) you can read more about:
42     - Command line usage and return codes
43     - Task Definition File (UserDetect2.ini)
44     - Troubleshooting
45     - Plugin development / SDK
46     - Migration from the software "testuser" (predecessor)
47     - Known issues
48     - Changelog
49     - Contact the author
51     ## License
53     This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
55     This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.