diff --git a/README.md b/README.md index 076e78c..d44a55a 100644 --- a/README.md +++ b/README.md @@ -1,48 +1,42 @@ -# **webrtc-ip** -💻 Gets a users public IP address in the browser. - - -### NOTICE: -This script no longer gets users private IP addresses, due to security concerns originating with the teams at Google and Apple, but reliably gets public ones. For more information, please read [this](https://bloggeek.me/psa-mdns-and-local-ice-candidates-are-coming/) great article that explains all you need to know. - +

+ +
+

+

+ + Build Status + + + Apache 2.0 License + + + Github contributors + + + Snyk vulnerabilities + + + PRs welcome + +

+ +
-### Disclaimer This software is for educational purposes only. This software should not be used for illegal activity. The author is not responsible for its use. - ---- - +## Quick Start + +To use `webrtc-ips`, you need to include the `` section of your HTML document. -### Getting Started -If you are using this in the browser, include the following script in the `` part of your HTML to access the `getIPs()` function: ```html ``` - -You now have access to the `getIPs()` function. - - -### Alternatives - -If you don't want to include this as a script, you can run the code on the website like this: -```js -(async() => { - eval(await (await fetch("https://cdn.jsdelivr.net/gh/joeymalvinni/webrtc-ip/dist/bundle.dev.js")).text()); - alert(await getIPs()); -})() -``` -Please note: this does not work on sites like Github where `unsafe-eval` is disabled. +Now you have access to the `getIPs()` function: ---- - - - -### Usage - ```js // Using Promises: getIPs().then(data=>{ @@ -56,67 +50,16 @@ getIPs().then(data=>{ })(); ``` -# webrtc-ip - -💻 Gets a users public IP address in the browser. - -## Getting Started - -These instructions will get you a copy of the project up and running on your local machine to test the example server. - -### Prerequisites - -Clone the github repository (you will need Node.js and NPM installed on your device): - -``` -$ git clone https://github.com/joeymalvinni/webrtc-ip.git -``` - - -### Installing - -Install dependencies: - -``` -npm install -``` - -Start up the server: - -``` -$ npm start -``` - -The example server should now be running on `http://localhost`. - -## Running the tests - -If you would like to triple check that this server works, you can test it: - -``` -npm test -``` - -## Contributing - -Please read [CONTRIBUTING.md](https://gist.github.com/PurpleBooth/b24679402957c63ec426) for details on our code of conduct, and the process for submitting pull requests to us. - -## Versioning - -We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/joeymalvinni/webrtc-ip/tags). +## Examples + The example (located at [`/example`](https://github.com/joeymalvinni/webrtc-ip/tree/main/example)) is being hosted on [Heroku](https://webrtc-ip.herokuapp.com/). + ## Authors -* **Joseph Malvinni** - *Initial work* - [joeymalvinni](https://github.com/joeymalvinni) +The author of webrtc-ips is [Joey Malvinni](https://github.com/joeymalvinni) -See also the list of [contributors](https://github.com/your/project/contributors) who participated in this project. +[List of all contributors](https://github.com/joeymalvinni/webrtc-ips/graphs/contributors) ## License -This project is licensed under the Apache 2.0 License - see the [LICENSE.md](LICENSE.md) file for details - -## Acknowledgments - -* Code inspiration taken from -* Inspiration -* etc + [Apache 2.0](LICENSE)