Merge pull request #7 from Stone-Red-Code/develop

Fix snapcraft.yaml?

.gitignore

@@ -332,3 +332,6 @@ ASALocalRun/
 
 # Local History for Visual Studio
 .localhistory/
+
+# Snapcraft
+*.snap

ARP-Scanner/ARP-Scanner.csproj

@@ -1,23 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFramework>net6.0</TargetFramework>
-    <RootNamespace>ARP_Scanner</RootNamespace>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="ArpLookup" Version="2.0.3" />
-    <PackageReference Include="IPAddressRange" Version="5.0.0" />
-    <PackageReference Include="Stone_Red-C-Sharp-Utilities" Version="1.0.3.1" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <None Update="mac-vendors.csv">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-    </None>
-  </ItemGroup>
-
-</Project>

ARP-Scanner/MacVendorLookup.cs

@@ -1,57 +0,0 @@
-using System.Text.RegularExpressions;
-
-namespace ARP_Scanner;
-
-internal class MacVendorLookup
-{
-    public readonly string[] header;
-    private readonly string[][] fields;
-
-    public MacVendorLookup(string csvPath)
-    {
-        if (!File.Exists(csvPath))
-        {
-            header = Array.Empty<string>();
-            fields = Array.Empty<string[]>();
-            return;
-        }
-
-        string[] lines = File.ReadAllLines(csvPath);
-
-        header = lines[0].Split(',');
-        fields = lines.Skip(1).Select(l => Regex.Split(l, ",(?=(?:[^\"]*\"[^\"]*\")*(?![^\"]*\"))")).ToArray();
-    }
-
-    public string[] GetInformation(string macAdress)
-    {
-        string[]? data = fields.FirstOrDefault(f => macAdress.StartsWith(f[0]))?.ToArray();
-
-        if (fields.Length == 0 || header.Length == 0)
-        {
-            return Array.Empty<string>();
-        }
-        else if (data is null)
-        {
-            string[] result = new string[header.Length - 1];
-            for (int i = 0; i < result.Length; i++)
-            {
-                result[i] = "Unknown";
-            }
-            return result;
-        }
-        else
-        {
-            List<string> result = new List<string>();
-            for (int i = 1; i < header.Length; i++)
-            {
-                result.Add($"{data[i]}");
-            }
-            return result.ToArray();
-        }
-    }
-
-    public string[] GetHeader()
-    {
-        return header!.Skip(1).ToArray();
-    }
-}

ARP-Scanner/Program.cs

@@ -1,111 +0,0 @@
-using ArpLookup;
-
-using NetTools;
-
-using Stone_Red_Utilities.CollectionExtentions;
-using Stone_Red_Utilities.ConsoleExtentions;
-
-using System.Collections.Concurrent;
-using System.Net;
-using System.Net.NetworkInformation;
-
-namespace ARP_Scanner;
-
-internal static class Program
-{
-    private static async Task Main(string[] args)
-    {
-        bool success = false;
-        IPAddress[]? ipAddresses = null;
-        MacVendorLookup macVendorLookup = new MacVendorLookup("mac-vendors.csv");
-
-        if (!Arp.IsSupported)
-        {
-            ConsoleExt.WriteLine("ARP is not supported on this platform!", ConsoleColor.Red);
-            return;
-        }
-
-        if (args.Length >= 1)
-        {
-            success = IPAddressRange.TryParse(string.Join("", args), out IPAddressRange iPAddressRange);
-            ipAddresses = iPAddressRange.AsEnumerable().ToArray();
-        }
-
-        if (!success || ipAddresses is null)
-        {
-            ConsoleExt.WriteLine("Invalid IP range!", ConsoleColor.Red);
-            return;
-        }
-
-        int ipAddressesCount = ipAddresses.Length;
-        int processedIpAddressesCount = 0;
-
-        List<string> header = new List<string>() { "IP", "MAC" };
-        ConcurrentBag<string[]> activeHosts = new ConcurrentBag<string[]>();
-
-        header.AddRange(macVendorLookup.GetHeader());
-
-        ConsoleExt.WriteLine("Starting scan...", ConsoleColor.DarkYellow);
-
-        await Parallel.ForEachAsync(ipAddresses, async (ipAddress, _) =>
-        {
-            PhysicalAddress? mac = await Arp.LookupAsync(ipAddress);
-
-            int localProcessedIpAddressesCount = Interlocked.Increment(ref processedIpAddressesCount);
-            if (mac is not null)
-            {
-                string formattedMac = BitConverter.ToString(mac.GetAddressBytes());
-
-                List<string> info = new List<string> { ipAddress.ToString(), formattedMac };
-                info.AddRange(macVendorLookup.GetInformation(formattedMac));
-                ConsoleExt.WriteLine($"Progress: {localProcessedIpAddressesCount}/{ipAddressesCount} [{100d / ipAddressesCount * localProcessedIpAddressesCount:0.00}%] | Active: {ipAddress}", ConsoleColor.Green);
-                activeHosts.Add(info.ToArray());
-            }
-            else
-            {
-                ConsoleExt.WriteLine($"Progress: {localProcessedIpAddressesCount}/{ipAddressesCount} [{100d / ipAddressesCount * localProcessedIpAddressesCount:0.00}%] | Inactive: {ipAddress}", ConsoleColor.Red);
-            }
-        });
-
-        if (!activeHosts.IsEmpty)
-        {
-            Console.WriteLine(Environment.NewLine + "Active hosts:");
-
-            List<string[]>? activeHostsTable = activeHosts.ToList();
-
-            activeHostsTable.Insert(0, header.ToArray());
-
-            To2D(activeHostsTable.ToArray()).PrintTable(TableStyle.List);
-
-            ConsoleExt.WriteLine($"{Environment.NewLine}Found {activeHosts.Count} active hosts", ConsoleColor.Green);
-        }
-        else
-        {
-            ConsoleExt.WriteLine($"{Environment.NewLine}No active hosts found", ConsoleColor.Red);
-        }
-    }
-
-    private static T[,] To2D<T>(T[][] source)
-    {
-        try
-        {
-            int FirstDim = source.Length;
-            int SecondDim = source.GroupBy(row => row.Length).Single().Key; // throws InvalidOperationException if source is not rectangular
-
-            T[,]? result = new T[FirstDim, SecondDim];
-            for (int i = 0; i < FirstDim; ++i)
-            {
-                for (int j = 0; j < SecondDim; ++j)
-                {
-                    result[i, j] = source[i][j];
-                }
-            }
-
-            return result;
-        }
-        catch (InvalidOperationException)
-        {
-            throw new InvalidOperationException("The given jagged array is not rectangular.");
-        }
-    }
-}

README.md

@@ -4,15 +4,22 @@
 
 ## Usage
 
-1. Downlaod the latest relasse
-1. Start `ARP-Scanner.exe` or `ARP-Scanner` on linux with the IP range it should scan as parameter
+1. Download the latest release
+   - Chocolatey (Windows): `choco install arp-scanner`
+   - Snapcraft (Linux): `snap install arp-scanner`
+   - GitHub (Windows/Linux): https://github.com/Stone-Red-Code/ARP-Scanner/releases
+1. Start `arp-scanner` with the IP range it should scan as parameter (e.g. `192.168.1.0 - 192.168.1.255`)
 
-> Note: This programm may not work on all linux distributions because the [ArpLookup](https://github.com/georg-jung/ArpLookup) library has some [limitations](https://github.com/georg-jung/ArpLookup#supported-platforms)
+> [!Note]
+> This programm may not work on all linux distributions because the [ArpLookup](https://github.com/georg-jung/ArpLookup) library has some [limitations](https://github.com/georg-jung/ArpLookup#supported-platforms)
+
+## Follow the development
+[![Twitter(X)](http://img.shields.io/badge/Twitter-black.svg?&logo=x&style=for-the-badge&logoColor=white)](https://twitter.com/search?q=%23ArpScanner%20%40StoneRedCode&f=live)
 
 ## Example
 ![ARP-Scanner-Example](https://user-images.githubusercontent.com/56473591/236293969-4e8a65d2-86a3-4f10-8837-2b1aa0490252.png)
 
 
-## Third party licences
+## Third party licenses
 - [ArpLookup](https://github.com/georg-jung/ArpLookup) - [MIT](https://github.com/georg-jung/ArpLookup/blob/master/LICENSE.txt)
 - [IPAddressRange](https://github.com/jsakamoto/ipaddressrange) - [MPL-2.0](https://github.com/jsakamoto/ipaddressrange/blob/master/LICENSE)

choco/ReadMe.md

@@ -0,0 +1,133 @@
+## Summary
+How do I create packages? See https://docs.chocolatey.org/en-us/create/create-packages
+
+If you are submitting packages to the community feed (https://community.chocolatey.org)
+always try to ensure you have read, understood and adhere to the create
+packages wiki link above.
+
+## Automatic Packaging Updates?
+Consider making this package an automatic package, for the best
+maintainability over time. Read up at https://docs.chocolatey.org/en-us/create/automatic-packages
+
+## Shim Generation
+Any executables you include in the package or download (but don't call
+install against using the built-in functions) will be automatically shimmed.
+
+This means those executables will automatically be included on the path.
+Shim generation runs whether the package is self-contained or uses automation
+scripts.
+
+By default, these are considered console applications.
+
+If the application is a GUI, you should create an empty file next to the exe
+named 'name.exe.gui' e.g. 'bob.exe' would need a file named 'bob.exe.gui'.
+See https://docs.chocolatey.org/en-us/create/create-packages#how-do-i-set-up-shims-for-applications-that-have-a-gui
+
+If you want to ignore the executable, create an empty file next to the exe
+named 'name.exe.ignore' e.g. 'bob.exe' would need a file named
+'bob.exe.ignore'.
+See https://docs.chocolatey.org/en-us/create/create-packages#how-do-i-exclude-executables-from-getting-shims
+
+## Self-Contained?
+If you have a self-contained package, you can remove the automation scripts
+entirely and just include the executables, they will automatically get shimmed,
+which puts them on the path. Ensure you have the legal right to distribute
+the application though. See https://docs.chocolatey.org/en-us/information/legal.
+
+You should read up on the Shim Generation section to familiarize yourself
+on what to do with GUI applications and/or ignoring shims.
+
+## Automation Scripts
+You have a powerful use of Chocolatey, as you are using PowerShell. So you
+can do just about anything you need. Choco has some very handy built-in
+functions that you can use, these are sometimes called the helpers.
+
+### Built-In Functions
+https://docs.chocolatey.org/en-us/create/functions
+
+A note about a couple:
+* Get-ToolsLocation - used to get you the 'tools' root, which by default is set to 'c:\tools', not the chocolateyInstall bin folder - see https://docs.chocolatey.org/en-us/create/functions/get-toolslocation
+* Install-BinFile - used for non-exe files - executables are automatically shimmed... - see https://docs.chocolatey.org/en-us/create/functions/install-binfile
+* Uninstall-BinFile - used for non-exe files - executables are automatically shimmed - see https://docs.chocolatey.org/en-us/create/functions/uninstall-binfile
+
+### Getting package specific information
+Use the package parameters pattern - see https://docs.chocolatey.org/en-us/guides/create/parse-packageparameters-argument
+
+### Need to mount an ISO?
+https://docs.chocolatey.org/en-us/guides/create/mount-an-iso-in-chocolatey-package
+
+### Environment Variables
+Chocolatey makes a number of environment variables available (You can access any of these with $env:TheVariableNameBelow):
+
+ * TEMP/TMP - Overridden to the CacheLocation, but may be the same as the original TEMP folder
+ * ChocolateyInstall - Top level folder where Chocolatey is installed
+ * ChocolateyPackageName - The name of the package, equivalent to the `<id />` field in the nuspec
+ * ChocolateyPackageTitle - The title of the package, equivalent to the `<title />` field in the nuspec
+ * ChocolateyPackageVersion - The normalized version of the package, equivalent to a normalized edition of the `<version />` field in the nuspec
+ * ChocolateyPackageFolder - The top level location of the package folder  - the folder where Chocolatey has downloaded and extracted the NuGet package, typically `C:\ProgramData\chocolatey\lib\packageName`.
+
+#### Advanced Environment Variables
+The following are more advanced settings:
+
+ * ChocolateyPackageParameters - Parameters to use with packaging, not the same as install arguments (which are passed directly to the native installer). Based on `--package-parameters`.
+ * CHOCOLATEY_VERSION - The version of Choco you normally see. Use if you are 'lighting' things up based on choco version. Otherwise take a dependency on the specific version you need.
+ * ChocolateyForceX86 = If available and set to 'true', then user has requested 32bit version. Automatically handled in built in Choco functions.
+ * OS_PLATFORM - Like Windows, macOS, Linux.
+ * OS_VERSION - The version of OS, like 10.0 something something for Windows.
+ * OS_NAME - The reported name of the OS.
+ * USER_NAME = The user name
+ * USER_DOMAIN = The user domain name (could also be local computer name)
+ * IS_PROCESSELEVATED = Is the process elevated?
+ * IS_SYSTEM = Is the user the system account?
+ * IS_REMOTEDESKTOP = Is the user in a terminal services session?
+ * ChocolateyToolsLocation - formerly 'ChocolateyBinRoot' ('ChocolateyBinRoot' will be removed with Chocolatey v2.0.0), this is where tools being installed outside of Chocolatey packaging will go.
+
+#### Set By Options and Configuration
+Some environment variables are set based on options that are passed, configuration and/or features that are turned on:
+
+ * ChocolateyEnvironmentDebug - Was `--debug` passed? If using the built-in PowerShell host, this is always true (but only logs debug messages to console if `--debug` was passed)
+ * ChocolateyEnvironmentVerbose - Was `--verbose` passed? If using the built-in PowerShell host, this is always true (but only logs verbose messages to console if `--verbose` was passed).
+ * ChocolateyExitOnRebootDetected - Are we exiting on a detected reboot? Set by ` --exit-when-reboot-detected`  or the feature `exitOnRebootDetected`
+ * ChocolateyForce - Was `--force` passed?
+ * ChocolateyForceX86 - Was `-x86` passed?
+ * ChocolateyRequestTimeout - How long before a web request will time out. Set by config `webRequestTimeoutSeconds`
+ * ChocolateyResponseTimeout - How long to wait for a download to complete? Set by config `commandExecutionTimeoutSeconds`
+ * ChocolateyPowerShellHost - Are we using the built-in PowerShell host? Set by `--use-system-powershell` or the feature `powershellHost`
+
+#### Business Edition Variables
+
+ * ChocolateyInstallArgumentsSensitive - Encrypted arguments passed from command line `--install-arguments-sensitive` that are not logged anywhere.
+ * ChocolateyPackageParametersSensitive - Package parameters passed from command line `--package-parameters-sensitive` that are not logged anywhere.
+ * ChocolateyLicensedVersion - What version is the licensed edition on?
+ * ChocolateyLicenseType - What edition / type of the licensed edition is installed?
+ * USER_CONTEXT - The original user context - different when self-service is used (Licensed)
+
+#### Experimental Environment Variables
+The following are experimental or use not recommended:
+
+ * OS_IS64BIT = This may not return correctly - it may depend on the process the app is running under
+ * CHOCOLATEY_VERSION_PRODUCT = the version of Choco that may match CHOCOLATEY_VERSION but may be different - based on git describe
+ * IS_ADMIN = Is the user an administrator? But doesn't tell you if the process is elevated.
+ * IS_REMOTE = Is the user in a remote session?
+
+#### Not Useful Or Anti-Pattern If Used
+
+ * ChocolateyInstallOverride = Not for use in package automation scripts. Based on `--override-arguments` being passed.
+ * ChocolateyInstallArguments = The installer arguments meant for the native installer. You should use chocolateyPackageParameters instead. Based on `--install-arguments` being passed.
+ * ChocolateyIgnoreChecksums - Was `--ignore-checksums` passed or the feature `checksumFiles` turned off?
+ * ChocolateyAllowEmptyChecksums - Was `--allow-empty-checksums` passed or the feature `allowEmptyChecksums` turned on?
+ * ChocolateyAllowEmptyChecksumsSecure - Was `--allow-empty-checksums-secure` passed or the feature `allowEmptyChecksumsSecure` turned on?
+ * ChocolateyChecksum32 - Was `--download-checksum` passed?
+ * ChocolateyChecksumType32 - Was `--download-checksum-type` passed?
+ * ChocolateyChecksum64 - Was `--download-checksum-x64` passed?
+ * ChocolateyChecksumType64 - Was `--download-checksum-type-x64` passed?
+ * ChocolateyPackageExitCode - The exit code of the script that just ran - usually set by `Set-PowerShellExitCode`
+ * ChocolateyLastPathUpdate - Set by Chocolatey as part of install, but not used for anything in particular in packaging.
+ * ChocolateyProxyLocation - The explicit proxy location as set in the configuration `proxy`
+ * ChocolateyDownloadCache - Use available download cache? Set by `--skip-download-cache`, `--use-download-cache`, or feature `downloadCache`
+ * ChocolateyProxyBypassList - Explicitly set locations to ignore in configuration `proxyBypassList`
+ * ChocolateyProxyBypassOnLocal - Should the proxy bypass on local connections? Set based on configuration `proxyBypassOnLocal`
+ * http_proxy - Set by original `http_proxy` passthrough, or same as `ChocolateyProxyLocation` if explicitly set.
+ * https_proxy - Set by original `https_proxy` passthrough, or same as `ChocolateyProxyLocation` if explicitly set.
+ * no_proxy- Set by original `no_proxy` passthrough, or same as `ChocolateyProxyBypassList` if explicitly set.
+

choco/arp-scanner.nuspec

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Read this before creating packages: https://docs.chocolatey.org/en-us/create/create-packages -->
+<!-- It is especially important to read the above link to understand additional requirements when
+publishing packages to the community feed aka dot org (https://community.chocolatey.org/packages). -->
+
+<!-- Test your packages in a test environment:
+https://github.com/chocolatey/chocolatey-test-environment -->
+
+<!--
+This is a nuspec. It mostly adheres to https://docs.nuget.org/create/Nuspec-Reference. Chocolatey
+uses a special version of NuGet.Core that allows us to do more than was initially possible. As such
+there are certain things to be aware of:
+
+* the package xmlns schema url may cause issues with nuget.exe
+* Any of the following elements can ONLY be used by choco tools - projectSourceUrl, docsUrl,
+mailingListUrl, bugTrackerUrl, packageSourceUrl, provides, conflicts, replaces
+* nuget.exe can still install packages with those elements but they are ignored. Any authoring
+tools or commands will error on those elements
+-->
+
+<!-- You can embed software files directly into packages, as long as you are not bound by
+distribution rights. -->
+<!-- * If you are an organization making private packages, you probably have no issues here -->
+<!-- * If you are releasing to the community feed, you need to consider distribution rights. -->
+<!-- Do not remove this test for UTF-8: if “Ω” doesn’t appear as greek uppercase omega letter
+enclosed in quotation marks, you should use an editor that supports UTF-8, not this one. -->
+<package xmlns="http://schemas.microsoft.com/packaging/2015/06/nuspec.xsd">
+  <metadata>
+    <!-- == PACKAGE SPECIFIC SECTION == -->
+    <!-- This section is about this package, although id and version have ties back to the software -->
+    <!-- id is lowercase and if you want a good separator for words, use '-', not '.'. Dots are only
+    acceptable as suffixes for certain types of packages, e.g. .install, .portable, .extension,
+    .template -->
+    <!-- If the software is cross-platform, attempt to use the same id as the debian/rpm package(s)
+    if possible. -->
+    <id>arp-scanner</id>
+    <!-- version should MATCH as closely as possible with the underlying software -->
+    <!-- Is the version a prerelease of a version?
+    https://docs.nuget.org/create/versioning#creating-prerelease-packages -->
+    <!-- Note that unstable versions like 0.0.1 can be considered a released version, but it's
+    possible that one can release a 0.0.1-beta before you release a 0.0.1 version. If the version
+    number is final, that is considered a released version and not a prerelease. -->
+    <version>1.0.0.0</version>
+    <!-- <packageSourceUrl>Where is this Chocolatey package located (think GitHub)? packageSourceUrl
+    is highly recommended for the community feed</packageSourceUrl>-->
+    <!-- owners is a poor name for maintainers of the package. It sticks around by this name for
+    compatibility reasons. It basically means you. -->
+    <!--<owners>__REPLACE_YOUR_NAME__</owners>-->
+    <!-- ============================== -->
+
+    <!-- == SOFTWARE SPECIFIC SECTION == -->
+    <!-- This section is about the software itself -->
+    <title>Arp-Scanner</title>
+    <authors>Stone_Red</authors>
+    <!-- projectUrl is required for the community feed -->
+    <projectUrl>https://github.com/Stone-Red-Code/Arp-Scanner</projectUrl>
+    <!-- There are a number of CDN Services that can be used for hosting the Icon for a package.
+    More information can be found here:
+    https://docs.chocolatey.org/en-us/create/create-packages#package-icon-guidelines -->
+    <!-- Here is an example using Githack -->
+    <!--<iconUrl>http://rawcdn.githack.com/__REPLACE_YOUR_REPO__/master/icons/arp-scanner.png</iconUrl>-->
+    <!-- <copyright>Year Software Vendor</copyright> -->
+    <!-- If there is a license Url available, it is required for the community feed -->
+    <licenseUrl>https://github.com/Stone-Red-Code/ARP-Scanner/blob/main/LICENSE</licenseUrl>
+    <requireLicenseAcceptance>true</requireLicenseAcceptance>
+    <projectSourceUrl>https://github.com/Stone-Red-Code/Arp-Scanner</projectSourceUrl>
+    <!--<docsUrl>At
+    what url are the software docs located?</docsUrl>-->
+    <!--<mailingListUrl></mailingListUrl>-->
+    <!--<bugTrackerUrl></bugTrackerUrl>-->
+    <tags>arp-scanner arp</tags>
+    <summary>A lightweight cross-platform IP scanner</summary>
+    <description>
+      **Usage**
+
+      1. Download the latest release
+      - Chocolatey (Windows): `choco install arp-scanner`
+      - Snapcraft (Linux): `snap install arp-scanner`
+      - GitHub (Windows/Linux): https://github.com/Stone-Red-Code/ARP-Scanner/releases
+      2. Start `arp-scanner` with the IP range it should scan as parameter (e.g. `192.168.1.0 - 192.168.1.255`)
+
+      &gt; Note: This programm may not work on all linux distributions because the [ArpLookup](https://github.com/georg-jung/ArpLookup) library has some [limitations](https://github.com/georg-jung/ArpLookup#supported-platforms)
+
+      **Third party licenses**
+      - ArpLookup (https://github.com/georg-jung/ArpLookup) - MIT (https://github.com/georg-jung/ArpLookup/blob/master/LICENSE.txt)
+      - IPAddressRange (https://github.com/jsakamoto/ipaddressrange) - MPL-2.0 (https://github.com/jsakamoto/ipaddressrange/blob/master/LICENSE)
+    </description>
+    <!-- <releaseNotes>__REPLACE_OR_REMOVE__MarkDown_Okay</releaseNotes> -->
+    <!-- =============================== -->
+
+    <!-- Specifying dependencies and version ranges?
+    https://docs.nuget.org/create/versioning#specifying-version-ranges-in-.nuspec-files -->
+    <!--<dependencies>
+      <dependency id="" version="__MINIMUM_VERSION__" />
+      <dependency id="" version="[__EXACT_VERSION__]" />
+      <dependency id="" version="[_MIN_VERSION_INCLUSIVE, MAX_VERSION_INCLUSIVE]" />
+      <dependency id="" version="[_MIN_VERSION_INCLUSIVE, MAX_VERSION_EXCLUSIVE)" />
+      <dependency id="" />
+      <dependency id="chocolatey-core.extension" version="1.1.0" />
+    </dependencies>-->
+    <!-- chocolatey-core.extension -
+    https://community.chocolatey.org/packages/chocolatey-core.extension -->
+
+    <!--<provides>NOT
+    YET IMPLEMENTED</provides>-->
+    <!--<conflicts>NOT
+    YET IMPLEMENTED</conflicts>-->
+    <!--<replaces>NOT
+    YET IMPLEMENTED</replaces>-->
+  </metadata>
+  <files>
+    <!-- this section controls what actually gets packaged into the Chocolatey package -->
+    <file src="tools\**" target="tools" />
+    <file src="..\src\ARP-Scanner\bin\Release\net8.0\**" target="tools" />
+  </files>
+</package>

choco/tools/LICENSE.txt

@@ -0,0 +1,25 @@
+From: https://github.com/Stone-Red-Code/ARP-Scanner
+
+LICENSE
+
+MIT License
+
+Copyright (c) 2021 Stone_Red
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

choco/tools/VERIFICATION.txt

@@ -0,0 +1,8 @@
+VERIFICATION
+Verification is intended to assist the Chocolatey moderators and community
+in verifying that this package's contents are trustworthy.
+
+Source Code: https://github.com/Stone-Red-Code/Arp-Scanner
+Releases: https://github.com/Stone-Red-Code/ARP-Scanner/releases
+Checksum: c37a793bae228da768c9d4223d12608bfa28decbe7142e9ac19a49795cf23b82b2f0434032b98883343c658276bf2e4423926fbf79c65c48ae6cf11ad48d37ad
+Veify using: certutil -hashfile C:\ProgramData\Chocolatey\lib\arp-scanner\ARP-Scanner.exe sha512

snap/snapcraft.yaml

@@ -0,0 +1,44 @@
+name: arp-scanner # you probably want to 'snapcraft register <name>'
+version: "1.0.0.0" # just for humans, typically '1.2+git' or '1.3.2'
+grade: stable # must be 'stable' to release into candidate/stable channels
+summary: A lightweight cross-platform IP scanner # 79 char long summary
+description: |
+  **Usage**
+
+  1. Download the latest release
+  - Chocolatey (Windows): `choco install arp-scanner`
+  - Snapcraft (Linux): `snap install arp-scanner`
+  - GitHub (Windows/Linux): https://github.com/Stone-Red-Code/ARP-Scanner/releases
+  1. Start `arp-scanner` with the IP range it should scan as parameter (e.g. `192.168.1.0 - 192.168.1.255`)
+
+  > Note: This programm may not work on all linux distributions because the [ArpLookup](https://github.com/georg-jung/ArpLookup) library has some [limitations](https://github.com/georg-jung/ArpLookup#supported-platforms)
+
+  **Third party licenses**
+  - ArpLookup (https://github.com/georg-jung/ArpLookup) - MIT (https://github.com/georg-jung/ArpLookup/blob/master/LICENSE.txt)
+  - IPAddressRange (https://github.com/jsakamoto/ipaddressrange) - MPL-2.0 (https://github.com/jsakamoto/ipaddressrange/blob/master/LICENSE)
+
+base: core22 # the base snap is the execution environment for this snap
+
+architectures:
+  - build-on: amd64
+  - build-on: arm64
+
+confinement: strict # use 'strict' once you have the right plugs and slots
+
+parts:
+  arp-scanner:
+    # See 'snapcraft plugins'
+    plugin: dotnet
+    dotnet-build-configuration: Release
+    dotnet-self-contained-runtime-identifier: linux-x64
+    source: ./src/ARP-Scanner
+    build-packages:
+      - dotnet-sdk-8.0
+    stage-packages:
+      - libicu70
+
+apps:
+  arp-scanner:
+    command: ARP-Scanner
+    plugs:
+      - network-observe

src/ARP-Scanner/ARP-Scanner.csproj

@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <RootNamespace>ARP_Scanner</RootNamespace>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="ArpLookup" Version="2.0.3" />
+    <PackageReference Include="CuteUtils" Version="1.0.0" />
+    <PackageReference Include="IPAddressRange" Version="6.0.0" />
+  </ItemGroup>
+
+</Project>

src/ARP-Scanner/ExtentionMethods.cs

@@ -0,0 +1,52 @@
+using NetTools;
+
+using System.Diagnostics;
+
+namespace ARP_Scanner;
+
+internal static class ExtentionMethods
+{
+    public static long Count(this IPAddressRange ipAddresses)
+    {
+        byte[] byteBegin = ipAddresses.Begin.GetAddressBytes();
+        byte[] byteEnd = ipAddresses.End.GetAddressBytes();
+
+        long sum = 1;
+        for (int i = byteBegin.Length - 1; i >= 0; i--)
+        {
+            if (byteEnd[i] - byteBegin[i] == 0)
+            {
+                continue;
+            }
+
+            sum += (long)((byteEnd[i] - byteBegin[i]) * Math.Pow(2D, (double)(byteBegin.Length - 1 - i) * 8));
+            Debug.WriteLine(sum);
+        }
+
+        return sum;
+    }
+
+    public static T[,] To2D<T>(this T[][] source)
+    {
+        try
+        {
+            int FirstDim = source.Length;
+            int SecondDim = source.GroupBy(row => row.Length).Single().Key; // throws InvalidOperationException if source is not rectangular
+
+            T[,]? result = new T[FirstDim, SecondDim];
+            for (int i = 0; i < FirstDim; ++i)
+            {
+                for (int j = 0; j < SecondDim; ++j)
+                {
+                    result[i, j] = source[i][j];
+                }
+            }
+
+            return result;
+        }
+        catch (InvalidOperationException)
+        {
+            throw new InvalidOperationException("The given jagged array is not rectangular.");
+        }
+    }
+}

src/ARP-Scanner/MacDatabase.cs

@@ -0,0 +1,7 @@
+namespace ARP_Scanner;
+
+internal class MacDatabase
+{
+    public DateTime LastUpdate { get; set; }
+    public List<MacInformation> MacInformations { get; set; } = [];
+}

src/ARP-Scanner/MacInformation.cs

@@ -0,0 +1,21 @@
+using System.Text.Json.Serialization;
+
+namespace ARP_Scanner;
+
+internal class MacInformation
+{
+    [JsonPropertyName("macPrefix")]
+    public required string MacPrefix { get; set; }
+
+    [JsonPropertyName("vendorName")]
+    public required string VendorName { get; set; }
+
+    [JsonPropertyName("private")]
+    public bool? Private { get; set; }
+
+    [JsonPropertyName("blockType")]
+    public required string BlockType { get; set; }
+
+    [JsonPropertyName("lastUpdate")]
+    public required string LastUpdate { get; set; }
+}

src/ARP-Scanner/MacVendorLookup.cs

@@ -0,0 +1,95 @@
+using CuteUtils.Misc;
+
+using System.Net.Http.Json;
+using System.Text.Json;
+
+namespace ARP_Scanner;
+
+internal partial class MacVendorLookup
+{
+    private const string macLookupUrl = "https://maclookup.app/downloads/json-database/get-db";
+    private readonly HttpClient httpClient = new HttpClient() { Timeout = TimeSpan.FromSeconds(20) };
+
+    private MacDatabase macDatabase = new MacDatabase();
+
+    public async Task Initialize()
+    {
+        string cachePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "macDatabase.json");
+
+        // Snap support
+        string? snapUserCommon = Environment.GetEnvironmentVariable("SNAP_USER_COMMON");
+
+        if (snapUserCommon is not null)
+        {
+            cachePath = Path.Combine(snapUserCommon, "macDatabase.json");
+        }
+
+        if (File.Exists(cachePath))
+        {
+            try
+            {
+                macDatabase = JsonSerializer.Deserialize<MacDatabase>(File.ReadAllText(cachePath)) ?? new MacDatabase();
+            }
+            catch (Exception ex)
+            {
+                ConsoleExt.WriteLine($"Failed to read MAC database cache: {ex.Message}", ConsoleColor.Red);
+            }
+        }
+
+        // Update MAC database if it's older than a week
+        if (macDatabase.LastUpdate > DateTime.Now.AddDays(-7))
+        {
+            ConsoleExt.WriteLine("Using cached MAC database...", ConsoleColor.DarkYellow);
+            return;
+        }
+
+        ConsoleExt.WriteLine("Downloading MAC database from maclookup.app...", ConsoleColor.DarkYellow);
+
+        List<MacInformation>? newMacInformations = null;
+
+        try
+        {
+            newMacInformations = await httpClient.GetFromJsonAsync<List<MacInformation>>(macLookupUrl);
+        }
+        catch (Exception ex)
+        {
+            ConsoleExt.WriteLine($"Failed to download MAC database: {ex.Message}", ConsoleColor.Red);
+        }
+
+        if (newMacInformations is null)
+        {
+            if (macDatabase.MacInformations.Count != 0)
+            {
+                ConsoleExt.WriteLine("Failed to download MAC database, using cache...", ConsoleColor.DarkYellow);
+            }
+            else
+            {
+                ConsoleExt.WriteLine("Failed to download MAC database and no cache found, using empty database...", ConsoleColor.Red);
+            }
+        }
+        else
+        {
+            ConsoleExt.WriteLine("MAC database downloaded successfully!", ConsoleColor.Green);
+
+            _ = Directory.CreateDirectory(Path.GetDirectoryName(cachePath)!);
+
+            macDatabase.MacInformations = newMacInformations;
+            macDatabase.LastUpdate = DateTime.Now;
+            File.WriteAllText(cachePath, JsonSerializer.Serialize(macDatabase));
+        }
+    }
+
+    public MacInformation GetInformation(string macAdress)
+    {
+        macAdress = macAdress.Replace("-", ":")[..8].ToUpper();
+
+        return macDatabase.MacInformations.Find(m => m.MacPrefix == macAdress) ?? new MacInformation()
+        {
+            MacPrefix = macAdress,
+            VendorName = "Unknown",
+            BlockType = "Unknown",
+            Private = false,
+            LastUpdate = "Unknown"
+        };
+    }
+}

src/ARP-Scanner/Program.cs

@@ -0,0 +1,97 @@
+using ArpLookup;
+
+using CuteUtils.Misc;
+
+using NetTools;
+
+using System.Collections.Concurrent;
+using System.Net;
+using System.Net.NetworkInformation;
+
+namespace ARP_Scanner;
+
+internal static class Program
+{
+    private static async Task Main(string[] args)
+    {
+        MacVendorLookup macVendorLookup = new MacVendorLookup();
+
+        if (!Arp.IsSupported)
+        {
+            ConsoleExt.WriteLine("ARP is not supported on this platform!", ConsoleColor.Red);
+            return;
+        }
+
+        if (!IPAddressRange.TryParse(string.Join("", args), out IPAddressRange ipAddressRange))
+        {
+            ConsoleExt.WriteLine("Invalid IP range!", ConsoleColor.Red);
+            return;
+        }
+
+        await macVendorLookup.Initialize();
+
+        long ipAddressesCount = ipAddressRange.Count();
+        long processedIpAddressesCount = 0;
+        int numberOfDigits = ipAddressesCount.ToString().Length;
+
+        List<string> header = ["IP", "MAC"];
+        ConcurrentBag<string[]> activeHosts = [];
+
+        header.AddRange([nameof(MacInformation.VendorName), nameof(MacInformation.BlockType), nameof(MacInformation.Private), nameof(MacInformation.LastUpdate)]);
+
+        ConsoleExt.WriteLine("Starting scan...", ConsoleColor.DarkYellow);
+
+        await Parallel.ForEachAsync(ipAddressRange, async (IPAddress ipAddress, CancellationToken _) =>
+        {
+            PhysicalAddress? mac = null;
+            bool fail = false;
+
+            try
+            {
+                mac = await Arp.LookupAsync(ipAddress);
+            }
+            catch (Exception ex)
+            {
+                ConsoleExt.WriteLine($"Failed to lookup MAC address for {ipAddress}: {ex.Message}", ConsoleColor.Red);
+                fail = true;
+            }
+
+            long localProcessedIpAddressesCount = Interlocked.Increment(ref processedIpAddressesCount);
+            if (mac is not null && Array.Exists(mac.GetAddressBytes(), b => b != 0))
+            {
+                string formattedMac = BitConverter.ToString(mac.GetAddressBytes());
+
+                MacInformation macInformation = macVendorLookup.GetInformation(formattedMac);
+
+                List<string> info = [ipAddress.ToString(), formattedMac, macInformation.VendorName, macInformation.BlockType, macInformation.Private.ToString() ?? "Unknown", macInformation.LastUpdate];
+                ConsoleExt.WriteLine($"Progress: {localProcessedIpAddressesCount.ToString().PadLeft(numberOfDigits)}/{ipAddressesCount} [{100d / ipAddressesCount * localProcessedIpAddressesCount,6:##0.00}%] | Active: {ipAddress}", ConsoleColor.Green);
+                activeHosts.Add([.. info]);
+            }
+            else if (fail)
+            {
+                ConsoleExt.WriteLine($"Progress: {localProcessedIpAddressesCount.ToString().PadLeft(numberOfDigits)}/{ipAddressesCount} [{100d / ipAddressesCount * localProcessedIpAddressesCount,6:##0.00}%] | Failed: {ipAddress}", ConsoleColor.Red);
+            }
+            else
+            {
+                ConsoleExt.WriteLine($"Progress: {localProcessedIpAddressesCount.ToString().PadLeft(numberOfDigits)}/{ipAddressesCount} [{100d / ipAddressesCount * localProcessedIpAddressesCount,6:##0.00}%] | Inactive: {ipAddress}", ConsoleColor.Red);
+            }
+        });
+
+        if (!activeHosts.IsEmpty)
+        {
+            Console.WriteLine(Environment.NewLine + "Active hosts:");
+
+            List<string[]>? activeHostsTable = [.. activeHosts];
+
+            activeHostsTable.Insert(0, [.. header]);
+
+            activeHostsTable.ToArray().To2D().PrintTable(TableStyle.List);
+
+            ConsoleExt.WriteLine($"{Environment.NewLine}Found {activeHosts.Count} active hosts", ConsoleColor.Green);
+        }
+        else
+        {
+            ConsoleExt.WriteLine($"{Environment.NewLine}No active hosts found", ConsoleColor.Red);
+        }
+    }
+}