{"id":18809497,"url":"https://github.com/resourcepool/ssdp-client","last_synced_at":"2025-04-13T20:26:22.213Z","repository":{"id":23614673,"uuid":"99449604","full_name":"resourcepool/ssdp-client","owner":"resourcepool","description":"The most lightweight asynchronous Java SSDP (Simple Service Discovery Protocol) Client","archived":false,"fork":false,"pushed_at":"2023-12-14T20:26:50.000Z","size":108,"stargazers_count":51,"open_issues_count":2,"forks_count":21,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-05-28T15:23:00.119Z","etag":null,"topics":["android","async","asynchronous","client","discovery","java","service","ssdp"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/resourcepool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-05T21:52:57.000Z","updated_at":"2024-05-07T07:37:46.000Z","dependencies_parsed_at":"2023-02-12T10:15:25.276Z","dependency_job_id":null,"html_url":"https://github.com/resourcepool/ssdp-client","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resourcepool%2Fssdp-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resourcepool%2Fssdp-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resourcepool%2Fssdp-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/resourcepool%2Fssdp-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/resourcepool","download_url":"https://codeload.github.com/resourcepool/ssdp-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223602609,"owners_count":17171952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","async","asynchronous","client","discovery","java","service","ssdp"],"created_at":"2024-11-07T23:16:34.323Z","updated_at":"2024-11-07T23:16:35.235Z","avatar_url":"https://github.com/resourcepool.png","language":"Java","readme":"# ssdp-client\nA Simple Asynchronous SSDP/1.0 UPNP/1.1 Java Client using JDK APIs only.\n\nThis library works on Android as well.\n\n\n[![Build Status](https://travis-ci.org/resourcepool/ssdp-client.svg?branch=master)](https://travis-ci.org/resourcepool/ssdp-client)\n\n## Add it to your project\n\nJar Download:  \n[https://mvnrepository.com/artifact/io.resourcepool/ssdp-client](https://mvnrepository.com/artifact/io.resourcepool/ssdp-client)\n\n\nMaven:\n```xml\n\u003c!-- https://mvnrepository.com/artifact/io.resourcepool/ssdp-client --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.resourcepool\u003c/groupId\u003e\n    \u003cartifactId\u003essdp-client\u003c/artifactId\u003e\n    \u003cversion\u003e2.5.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\nGradle:\n```groovy\ncompile 'io.resourcepool:ssdp-client:2.5.1'\n```\n\n## Changelog\n\n### 2.5.1\n* Fixed release issue\n\n### 2.5.0\n* #32 Handle multiple responses on its own\n* #33 Response misc behaviour\n* #35 Fixed NPE\n\n### 2.4.5\n* #28 Fixed Android issue with potential interfaces not supporting Multicast\n* #29 Fixed potential NPE when stopping discovery as incoming packets are still arriving\n* #30 Fixed potential NPE when closing multicast socket before initial discovery is performed\n* #31 Implemented new SsdpClientOption to disable autoLookup\n* #31 Fixed potential concurrent modifications of the request list\n\n### 2.4.4\n* #27 Fixed Android emulator issue\n\n### 2.4.3\n * #22 Fixed multicast addressed datagrams\n * #23 Bumb versions\n\n### 2.4.2\n * #21 Fixed notify message regex\n\n### 2.4.1\n * #19 Fixed non-static builder method\n\n### 2.4.0\n * #17 Fixed default options and newline bug\n * #18 Allow users to send packets without user-agent header\n * Version bumps\n\n### 2.3.0\n * #9 Solved race condition on null callback\n * #13 Added custom interval between requests\n * #14 Added DiscoveryOptions and custom USER-AGENT and MX headers\n\n### 2.2.0\n * #5 Solved discovery request cleaned after first call\n * #7 Solved regex parsing issue on headers with multiple spaced semicolumns\n\n### 2.1.0\n * #4 Solved dynamic port on client socket binding\n\n### 2.0.0\n * #2 Put Client builder as static\n * Support Update announcement of SSDP\n * Refactored packages (get ready for Java 9 module one day)\n### 1.2.0\n * #1 Fixed NPE when no Serial Number\n### 1.1.0\n * Resolved issue when closing socket\n * Updated docs\n \n## Usage\n\nDiscover all SSDP services:\n\n```java\n    SsdpClient client = SsdpClient.create();\n    DiscoveryRequest all = SsdpRequest.discoverAll();\n    client.discoverServices(all, new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\nDiscover specific SSDP service by serviceType (simple version):\n\n```java\n    SsdpClient client = SsdpClient.create();\n    \n    DiscoveryRequest networkStorageDevice = SsdpRequest.builder()\n    .serviceType(\"urn:schemas-upnp-org:device:networkstoragedevice:1\")\n    .build();\n    client.discoverServices(networkStorageDevice, new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\nDiscover specific SSDP service by serviceType (with custom options):\n\n```java\n    SsdpClient client = SsdpClient.create();\n    DiscoveryOptions options = DiscoveryOptions.builder()\n    .intervalBetweenRequests(10000L) // optional interval between requests, defaults to 10 000 milliseconds\n    .maxWaitTimeSeconds(3) // optional max wait time between req and response, defaults to 3 seconds\n    .userAgent(\"Resourcepool SSDP Client\") // optional custom user-agent, defaults to \"Resourcepool SSDP Client\"\n    .build();\n\n    DiscoveryRequest networkStorageDevice = SsdpRequest.builder()\n    .serviceType(\"urn:schemas-upnp-org:device:networkstoragedevice:1\")\n    .discoveryOptions(options) // optional as well. \n    .build();\n    client.discoverServices(networkStorageDevice, new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\n\nDiscover specific SSDP service by serviceType (with custom options):\n\n```java\n    SsdpClient client = SsdpClient.create();\n    DiscoveryOptions options = DiscoveryOptions.builder()\n    .intervalBetweenRequests(10000L) // optional interval between requests, defaults to 10 000 milliseconds\n    .maxWaitTimeSeconds(3) // optional max wait time between req and response, defaults to 3 seconds\n    .userAgent(\"Resourcepool SSDP Client\") // optional custom user-agent, defaults to \"Resourcepool SSDP Client\"\n    .build();\n\n    DiscoveryRequest networkStorageDevice = SsdpRequest.builder()\n    .serviceType(\"urn:schemas-upnp-org:device:networkstoragedevice:1\")\n    .discoveryOptions(options) // optional as well. \n    .build();\n    client.discoverServices(networkStorageDevice, new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\nDiscovery is not a mandatory activity. You might just want to listen to announcements:\n```java\n    SsdpClient client = SsdpClient.create();\n    client.discoverServices(null, new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\n\nDisabling automatic lookup for unknown incoming announcements\n\n```java\n    SsdpClient client = SsdpClient.create();\n    DiscoveryRequest all = SsdpRequest.discoverAll();\n    DiscoveryOptions options = DiscoveryOptions.builder()\n     .intervalBetweenRequests(10000L) // optional interval between requests, defaults to 10 000 milliseconds\n     .maxWaitTimeSeconds(3) // optional max wait time between req and response, defaults to 3 seconds\n     .userAgent(\"Resourcepool SSDP Client\") // optional custom user-agent, defaults to \"Resourcepool SSDP Client\"\n     .overrideBindingPort(1901)\n     .build();\n    client.discoverServices(all, options, new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\nIgnoring unavailable Multicast Interface errors \n\n```java\n    SsdpClient client = SsdpClient.create();\n    DiscoveryRequest all = SsdpRequest.discoverAll();\n    client.discoverServices(all, SsdpClientOptions.builder().ignoreInterfaceDiscoveryErrors().build(), new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\n\nOverriding default binding port (defaults to **1900**)\n\n```java\n    SsdpClient client = SsdpClient.create();\n    DiscoveryRequest all = SsdpRequest.discoverAll();\n    client.discoverServices(all, SsdpClientOptions.builder().ignoreInterfaceDiscoveryErrors().build(), new DiscoveryListener() {\n      @Override\n      public void onServiceDiscovered(SsdpService service) {\n        System.out.println(\"Found service: \" + service);\n      }\n\n      @Override\n      public void onServiceAnnouncement(SsdpServiceAnnouncement announcement) {\n        System.out.println(\"Service announced something: \" + announcement);\n      }\n    });\n```\n\n\nWhen you're done, don't forget to stop the discovery:\n```java\nssdpClient.stopDiscovery();\n```\n\n## License\n   Copyright 2016-2022 Resourcepool\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresourcepool%2Fssdp-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresourcepool%2Fssdp-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresourcepool%2Fssdp-client/lists"}