404gamernotfound/scriptable-show-my-ip-widget

This Scriptable widget, designed for iOS, displays your current public IP address in a small-sized widget format. Upon adding to your home screen, it fetches and shows your IP using an external API, providing a quick and easy way to view your public IP at a glance.

IP Address Widget for Scriptable

This repository contains a Scriptable widget script for iOS that displays the user's current public IP address. The widget is designed to be small and efficient, making it easy to view your IP address directly from your home screen.

Features

• Simple Display: Shows your public IP address in a clear and concise manner.
• Small Widget Size: Designed to fit perfectly as a small widget on your iOS home screen.
• Automatic Updating: Fetches the latest IP address using an external API.
• Easy to Install: Quick setup with minimal configuration required.

Requirements

• iOS device
• Scriptable app installed from the App Store.

Installation

1. Download Scriptable: Ensure you have the Scriptable app installed on your iOS device.

2. Add the Script:

   • Open the Scriptable app.
   • Tap the '+' icon to create a new script.
   • Copy and paste the script from the ip_widget.js file in this repository into the new script.

3. Add the Widget:

   • Long-press on your home screen to enter 'jiggle mode'.
   • Tap the '+' icon in the top left corner.
   • Find and select Scriptable from the list.
   • Choose the small widget size and add it to your home screen.
   • Select the widget, then choose the ip_widget script.

4. Enjoy: Your widget should now display your current public IP address.

Configuration

No additional configuration is required. The widget will automatically fetch and display your current public IP address.

Contributing

Contributions to the widget script are welcome. Please feel free to fork the repository, make your changes, and create a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to ipify API for providing the IP address data.
• Scriptable by Simon Støvring for making this possible on iOS.