fingscan  

Developer: Karl's Plugins     Like this plugin? Show your appreciation!
Category: Location and Presence
Github: Github Repo
Assistance: Get help!   
Plugin ID: com.karlwachs.fingscan
Latest release: v2022.37.95 released on May 8, 2023
Requires: Indigo v2022.1.0 or higher
(Check the Releases tab below for older releases that may have different requirements)
  Download latest release

fingscan

indigo plugin that uses FING and other utilities to detect presence of ip devices see https://forums.indigodomo.com/viewforum.php?f=166&sid=930a0fbb75a1efd6ca07b67371083571 for details

Release details
Released on: May 8, 2023
Requires: Indigo v2022.1.0+
Changes in this release

new fing version attached

Release details
Released on: May 8, 2023
Requires: Indigo v2022.1.0+
Downloaded: 1 times 
Changes in this release

added error catching in startfing

Release details
Released on: May 8, 2023
Requires: Indigo v2022.1.0+
Changes in this release

added start fing debug option in config

Release details
Released on: Oct. 16, 2022
Requires: Indigo v2022.1.0+
Changes in this release

fingscan Warning getting data from indigo: bad variable ipDevice03 does not have a valid IP number>>192.168.86.237-changed<<\ deleting and letting .. and stopping plugin

Release details
Released on: Sept. 24, 2022
Requires: Indigo v2022.1.0+
Changes in this release

statusDisplay date stamp was changed during reload of the plugin. e.g. during auto reload at 1pm, can be switch off in config) that is fixed now: no device state updated until 100 secs into the plugin running. this was due to data loaded from differnt sources during startup. after everything is loaded the inetrnal data is correct.

Release details
Released on: Sept. 20, 2022
Requires: Indigo v2022.1.0+
Changes in this release

name of newly created devices are now: MAC-xx:xx:xx:xx:xx-Vendor info like: MAC-5C:87:xx:0A:xx:xx-Apple

Release details
Released on: Sept. 20, 2022
Requires: Indigo v2022.1.0+
Changes in this release

fixed: 'Plugin' object has no attribute 'M2V' this happens when vendor loockup is disabled variables are now properly initialized

Release details
Released on: Sept. 18, 2022
Requires: Indigo v2022.1.0+
Changes in this release

fixed: TypeError: object of type 'NoneType' has no len()

Release details
Released on: Sept. 15, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. bug fix: variable allaway_x was set properly but at next cycle reset reason: was one deleted line in python code
Release details
Released on: Sept. 12, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. bug fix: dev states for email after new device event where not populated in time hence ip# and hardware info where not available in time. after some seconds they were populated this was introduced with the last update
Release details
Released on: Sept. 3, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. some bug fixes
  2. removed nickname info as this is not consistent and creates more confusion that it adds value
Release details
Released on: Aug. 31, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. removed dead code (findmy , pibeacon, unifi interfaces)
  2. fixed restore devices
  3. fixed one py2->py3 i/o issue (in network scan, write to log)
  4. streamlined menu structure
  5. fixed lookup of vendor
  6. status-date stamp is fixed at startup if datestamp is empty. previously it was changed once device changes state up->down .. now also initial datestamp is not 0 but proper datestamp
  7. reload / restart of plugin is now configurable in config to be [disabled, start at 0:19, 1:19, 2:19]
Release details
Released on: Aug. 29, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. removed dead code (findmy , pibeacon, unifi interfaces)
  2. fixed restore devices
  3. fixed one py2->py3 i/o issue ( in network scan, write to log)
  4. streamlined menu structure
Release details
Released on: Aug. 27, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. fixed error: File "plugin.py", line 2681, in writeToFile f.write(writestring.encode("utf8"))
Release details
Released on: Aug. 11, 2022
Requires: Indigo v2022.1.0+
Changes in this release

moved network detection to front, in case config is started immediately, some varaibles are not initialized

Release details
Released on: Aug. 11, 2022
Requires: Indigo v2022.1.0+
Changes in this release

fixed wake onlan decode() not ... error. was left over from py2 --> py3

Release details
Released on: June 27, 2022
Requires: Indigo v2022.1.0+
Changes in this release
  1. changed password storage, was stored in mac keychain. that apparently does not work anymore. now stored in preferences file the plugin will convert to preference stored password automatically.
  2. will require indigo 2022, py3
Release details
Released on: May 23, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release
  1. fixed: getfingData @line 3174: 'if self.fingStatus[kk] == "up" and self.allDeviceInfo[theMAC][u"status"] != u"up":'
Release details
Released on: May 14, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

fixed: getIgnoredMAC @line 2772: 'self.indiLOG.log(40, u"getIgnoredMAC file read:{}".format(xx))'

Release details
Released on: April 20, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release
  1. some cleanup for migration py2 --> py3
  2. faster down --> up state change (up to 60 secs faster ), read from fing.log file did not work, only fing.data was used
Release details
Released on: April 15, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

ip broadcast calculatiuon was messed up was x.x.x.254 instead of x.x.x.255 error was: max_range = copy.copy(broadcast) # copy.copy is needed, otherwise broadcast itself is changed max_range[-1] -= 1

Release details
Released on: April 14, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

isolate a possible no network state in wake on lan, with try: // except the plugin will continue, but will not do wake on lan

Release details
Released on: April 12, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

added support for python3 fixed ''unicode' object has no attribute 'pid''

Release details
Released on: March 29, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

updated libraries etc for os 12.3 and indigo 2021.1

Release details
Released on: Aug. 22, 2021
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added upper() for reading ignored mac to allow aa:bb:cc:dd:ee:ff besides AA:BB:CC:DD:EE:FF in file ignoredMAC

Release details
Released on: Feb. 18, 2021
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

Added features / changes in v7.32.65 @ 2021-2-18

  1. fixed error message: fingscan Error error in Line# 788 ; error=list index out of range replaced with a more meaning full error message happens when fing is not (properly) installed or password is not set

Added features / changes in v7.32.64 @ 2020-11-24

  1. added variables: nAwayX and nHomeX = number of devices in event group X being away / home) you can use that to trigger on eg 2 or more devices in the event group being home or away. eg: assume you have defined an event group X with 5 members set up trigger with "variable changed" nAwayX and becomes >1 it would trigger if it goes from 1 to 2 devices away, not from 2 to 3 and similar to nHomeX
Release details
Released on: Nov. 24, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added variables: nAwayX and nHomeX = number of devices in event group X being away / home) you can use that to trigger on eg 2 or more devices in the event group being home or away. eg: asume you have defined an event group X with 5 members set up trigger with "variable changed" nAwayX and becomes >1 it would trigger if it goes from 1 to 2 devices away, not from 2 to 3 and similar to nHomeX

Release details
Released on: Oct. 28, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added check (try, except) for datestamp in fing.data

Release details
Released on: Oct. 27, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added check (try, except) for datestamp in fing.data

Release details
Released on: Oct. 27, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added debug-log statements for startfing

Release details
Released on: Oct. 21, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

set enableBroadCastEvents to defalut if not set in config

Release details
Released on: Oct. 20, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added several save prefs commands in code to make sure event defs are not lost

Release details
Released on: Oct. 17, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release
  1. added check if vendor field is empty
  2. added a lot of unicode ie u" instead of " and unicode() instead of str()
Release details
Released on: Oct. 12, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

if a devices is not found (indigo return error), it is not auto-removed from events the user is asked to remove device from event list this should cover the casese where indigo has timeouts

Release details
Released on: Feb. 13, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

fixed mac to vendor look up plugin exit when disabled

Release details
Released on: Feb. 10, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added suppression of variables SQL logging, available with indigo 7.4.1

Release details
Released on: Jan. 24, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

added loggin statement in case empty or bad data is read from indigo prefs file for EVENTS data

Release details
Released on: Jan. 19, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

fix: Error error in Line# 535 ; error=global name 'fingVersion' is not defined

Release details
Released on: Jan. 17, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

Error error in Line# 535 ; error=global name 'opsys' is not defined

Release details
Released on: Jan. 11, 2020
Requires: Indigo v7.3.0 thru v2022.2
Downloaded: 0 times 
Changes in this release
  1. enabled service scan menu point for catalina.. 3rd time is the charm .. and thanks to David for patiently helping debugging
Release details
Released on: Jan. 11, 2020
Requires: Indigo v7.3.0 thru v2022.2
Changes in this release

enabled service scan menu point for catalina

Release details
Released on: Jan. 10, 2020
Requires: Indigo v7.3.0 thru v2022.2
Downloaded: 0 times 
Changes in this release
  1. enabled fing v 5.x for OSX catalina (>=10.15) you MUST install fing version 5.x for this either download https://www.fing.com/products/development-toolkit use OSX button or use /Library/Application Support/Perceptive Automation/Indigo 7.4/Plugins/fingscan.indigoPlugin/Contents/Server Plugin/CLI_macOSX_5.4.0.zip
Release details
Released on: Jan. 8, 2020
Requires: Indigo v7.3.0 thru v2022.2
Downloaded: 0 times 
Changes in this release
  1. moved most of initializing code (reading from config, starting fing ..) into thread loop. that enabled time.sleep() to edit config
  2. added check if mac number is properly defined in events, or deleted ..added check for "error in Line '2074' "
Release details
Released on: Dec. 5, 2019
Requires: Indigo v7.3.0 thru v2022.2
Downloaded: 0 times 
Changes in this release

fixed issue at startup when password is not defined will give user 200 seconds to finish config , then manual reload is required

Release details
Released on: Nov. 7, 2019
Requires: Indigo v7.3.0 thru v2022.2
Downloaded: 0 times 
Changes in this release

added auto delete of variable if not comple, and recreate

Release details
Released on: Nov. 7, 2019
Requires: Indigo v7.3.0 thru v2022.2
Downloaded: 0 times 
Changes in this release
  1. added attrib change for fing.bin to enable running under catalina
  2. converted to std indigo logging will require indigo 7.3 or higher
Release details
Released on: Sept. 13, 2018
Requires: Indigo v7.0.2 thru v2022.2
Downloaded: 0 times 
Changes in this release

When network defs are not present now sets default in startup, so that you can set parameters in config after start

Release details
Released on: Sept. 10, 2018
Requires: Indigo v7.0.2 thru v2022.2
Downloaded: 0 times 
Changes in this release

bugfix key debugMother not found in dict and one other bug (trigger unifi devices changes exception)

Release details
Released on: Sept. 8, 2018
Requires: Indigo v7.0.2 thru v2022.2
Downloaded: 0 times 
Changes in this release

ipDevsOldNewIPNumber is set when a device changes its ip number contents: devName/mac#/oldIP/newIP you can use it with items= (indigo.variable["ipDevsOldNewIPNumber"].value).split("/") then items[0] = devName items[1] = mac# ...

Release details
Released on: Sept. 8, 2018
Requires: Indigo v7.0.2 thru v2022.2
Downloaded: 0 times 
Changes in this release

ipDevsOldNewIPNumber is set when a device changes its ip number
contents: devName/mac#/oldIP/newIP
you can use it with
items= (indigo.variables["ipDevsOldNewIPNumber"].value).split("/")
then
items[0] = devName
items[1] = mac#
...

Release details
Released on: Aug. 16, 2018
Requires: Indigo v7.0.2 thru v2022.2
Downloaded: 4 times 
Changes in this release

v7.29.32

Release details
Released on: Aug. 1, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

added support for indigo broadcasts
messages are like:

{'pluginId': u'com.karlwachs.fingscan', 'data': [{'name': u'fing-rpi-16-attic-zerow', 'id': '39359595', 'state': 'status', 'valueForON': 'up', 'action': 'event', 'newValue': 'down'}]}

Requirements

indigo 7.1

Release details
Released on: July 21, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

error in Line '5297' ; error=''lastFingUp'' fixed

Requirements

indigo 7

Release details
Released on: July 21, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

added options to ignore
- specific MAC - in menu select add MAC to ignore list -- no action, update will be done for these devices or variables in the plugin, if you delete an ignored indigo device it will not be recreated, you can added them back with remove MC from, ignored list in menu - any new device -- no newly discovered devices are added. If you delete a indigo device, it will not be added back

removed mother devices

Requirements

indigo 7

Release details
Released on: June 4, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

fixed variable init not defined

Requirements

indigo 7

Release details
Released on: June 4, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

version 7.27.25 had variable FingEventDevChangedIndigoId removed. put back in

Requirements

indigo 7

Release details
Released on: June 4, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

the plugin now supports: send wake on lan packets to ipdevices. It has to be set for each device individually. It "costs" ~ 0.3 secs per device and cycle

Added expiration timer to fing up --> down--> expired - set for each device individually in device edit The info for down / expired is delayed by xx seconds to the plugin. In case fing gets new UP info about the device the timer gets reset. In a test an iphone 7 and X stayed up for 24 hours w/o inetrruption when WakeOnLan was enabled too.

Requirements

indigo 7

Release details
Released on: April 23, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

added variable FingEventDevChangedIndigoId that shows the ID of the last changed device in an event

Requirements

indigo 7

Release details
Released on: March 15, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

as the current method to get the MAC to vendor look up is not working anymore (killed by web site), this version will make a copy from the official files on the IEEE web site and will lookup all MAC numbers locally. It requires a one time download (repeated every 10 days) then all look ups are done locally. ~ 2 Mbyte in total are used to store the info. the DCIT used is ~ 1Mbyte for ALL mac/vendor info

set refresh rate in config (# of days between refresh 0=off/7/14/21/30)

The files are stored in /Users/youruserid/indigo/mac2Vendor/

Karl

Requirements

indigo 7

Release details
Released on: March 3, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

now supports 3,4,5,6..16 bits of network scope

Requirements

indigo 7

Release details
Released on: Feb. 28, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

just a version # fix

Requirements

i 7

Release details
Released on: Jan. 23, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

bug fix: - fix menu if > 5 devices in event , config not saved

added: ==network range now any combination of network start address (eg 192.168.1.64 / 7 : 192.168.1.64 .. 96 range to 192.168.0.0 /16 = 192.168.0.0 .. 656536 range) default for most is 192.168.1.0/24 = 168.192.1.0..255

== sorting of devices in event print is better

Requirements

indigo6

Release details
Released on: Dec. 11, 2017
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release
  1. fixed events: in the names "-" was replace with "_", there was an occurrence where it was not done properly you should check all events defs and make sure they are consistent

  2. added back in network type = how many ip numbers should be scanned eg. 0...255 or 0..64

Requirements

indigo 6

Release details
Released on: Nov. 27, 2017
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

base release

docu still on indigo web site

Requirements

indigo v 6