mirror of
https://github.com/iamrbn/Reddit-Widget.git
synced 2026-08-24 10:04:26 -05:00
230 lines
10 KiB
Markdown
230 lines
10 KiB
Markdown
# <img title="Reddit Favicon" src="https://www.reddit.com/favicon.ico" width="27"/> Reddit widget for [Scriptable-App](https://scriptable.app/)
|
|
|
|
|
|
|
|
|
|
This widget shows your <img align="center" title="Karma Symbol" src="Images/karma.png" width="17"> Karma, <img align="center" title="Cakeday Symbol" src="Images/cakedayApollo.png" width="18"> Cakeday and Profile Image on your home and lockscreen
|
|
|
|
**Karma Widget**
|
|
<img title="Header Banner" src="Images/Screenshots/haederBanner2.png" width="1000" align="center">
|
|
<br>
|
|
<br>
|
|
|
|
|
|
This version of the widget shows your last Post on your home and lockscreen
|
|
|
|
**Last Post Widget**
|
|
<img title="Header Banner2" src="Images/Screenshots/bannerLastPost.png" width="1000" align="center">
|
|
<br>
|
|
|
|
<img title="Header Banner2" src="Images/Screenshots/LockscreenWidgets_Banner.png" width="1000" align="center">
|
|
<br>
|
|
<br>
|
|
|
|
|
|
|
|
<details open>
|
|
<summary><b>1.5 Update Notes (November 11th 2024)</b></summary>
|
|
|
|
- Module file has been added with parts of the original script for performance improvements
|
|
- Last post lockscreen-widgets have been revised
|
|
- Also added last post homescreen-widgets (small, medium, large)
|
|
- Removed some parts of the delete menu
|
|
- Some parts of the code that were not used have been removed
|
|
- General code improvements
|
|
|
|
<br>
|
|
|
|
<details>
|
|
<summary><b>1.4.1 Update Notes (January 17th 2024)</b></summary>
|
|
|
|
- Added a second Circular-Lockscreen-Widget, which shows upvotes and comments of your recent post/comment
|
|
- Added also Rectangular-Lockscree-Widget with the same functions
|
|
-> [Jump To Lockscreen Widgets](https://github.com/iamrbn/Reddit-Widget/blob/main/README.md#widget-parameter)
|
|
</details>
|
|
|
|
|
|
|
|
<details>
|
|
<summary><b>1.4 Update Notes (December 27th 2023)</b></summary>
|
|
|
|
- Added Circular-Lockscreen-Widget. It shows your total karma
|
|
- Small improvements of the Large-Widget
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>1.3.1 Update Notes (December 19th 2023)</b></summary>
|
|
|
|
- Removed 'Open Profile' dialog
|
|
- Added basics for lockscreen widgets
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>1.3 Update Notes (December 15th 2023)</b></summary>
|
|
|
|
- Removed the most 3rd party app icons due to recent api changes from reddit
|
|
- Added alternative reddit icons, like alienblue, classic & black
|
|
- Coin balance is replaced with your cakeday/account age
|
|
- The formatting of the karma values has been adjusted slightly
|
|
- Small Code improvements
|
|
- Added the option to set the widget background gradient into reddit-orange
|
|
(You have to move the comment brackets (```/*...*/```) to the default value)
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>1.2 Update Notes (July 20th 2022)</b></summary>
|
|
|
|
- Script Saves and pulls reddit login datas on device (~ iCloud/Scriptable/Reddit-Widget/LoginDatas.json)
|
|
- Downloads once profile image & app icons to iCloud for less mobile data usage
|
|
- Added 'Delete Menu ⌦' for Downloaded Files
|
|
- added first / error widget for all sizes
|
|
- Added unread messages badge for large widget, too!
|
|
- Added the reddit web-favicon and ReSurfer (_amazing reddit client, check it out_) as icon option.
|
|
- Added the option to use the web-browser instead of reddit, apollo or ReSurfer app (_If you also have the reddit app installed, iOS will first open the reddit app instead of the browser_)
|
|
- Fixed bug where long karma numbers may displayed cutted off in the small-widget
|
|
- Small design and functionality improvements
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>1.1 Update Notes (May 05th 2022)</b></summary>
|
|
|
|
- Updated Function for calculating karma numbers `(e.g. 1494 = 1.494K; 20567 = 20.57K; 1000000 = 1M etc.)`
|
|
- Added Feature notification Badge also for Medium Widget
|
|
- Added selfupdate function[^1]
|
|
</details>
|
|
|
|
|
|
<br>
|
|
|
|
## Overview
|
|
|
|
|
|
### Themes
|
|
The Widget has a **Dynamic Gradient Background**
|
|
|
|
<img title="Darkmode Orange - Medium Sized Widget" src="Images/Screenshots/RedditStyle_darkmodeGradient.png" width="250" align="center"> <img title="Lightmode White - Medium Sized Widget" src="Images/Screenshots/lightmodeGradient.png" width="250" align="center">
|
|
|
|
<br>
|
|
|
|
### First Run
|
|
When you add the widget but also saved your login datas (via script) youll get the Error/First Run Widget.
|
|
Open the Script an Enter your Datas from Reddit.
|
|
|
|
<img title="Preview Error/First Run Widget" src="Images/Screenshots/previewError-FirstRun_Widgets.png" width="500" align="center">
|
|
|
|
<br>
|
|
|
|
### Happy Cakeday Buddy
|
|
Today is your Cakeday!? The widget will tell you subtly.
|
|
|
|
<img title="Cakeday Banner" src="Images/Screenshots/cakedayBanner2.png" width="1000" align="center">
|
|
|
|
<br>
|
|
|
|
## ⚙️ SETUP
|
|
|
|
### Create Personal Reddit App/Script
|
|
|
|
1. Login to your Account and go to https://old.reddit.com/prefs/apps/
|
|
|
|
2. Create new **Personal Script**
|
|
<img title="create another app..." src="https://github.com/iamrbn/Reddit-Widget/blob/175d5a4fb4eced970edccb2dcf818f699d6a6bdc/Images/Screenshots/create_personal_script%5Bstep1%5D.png" width="850">
|
|
|
|
3. Click Checkbox "script" and set a redirect uri (e.g. same as in the image)
|
|
<img title="config app parameter" src="https://github.com/iamrbn/Reddit-Widget/blob/175d5a4fb4eced970edccb2dcf818f699d6a6bdc/Images/Screenshots/create_application%5Bstep2%5D.png" width="850">
|
|
|
|
4. Create App
|
|
|
|
5. Copy Client_ID & Client_Secret
|
|
<img title="get app parameter" src="https://github.com/iamrbn/Reddit-Widget/blob/175d5a4fb4eced970edccb2dcf818f699d6a6bdc/Images/Screenshots/new_application%5Bstep3%5D.png" width="850">
|
|
|
|
Official Reddit API Guidelines: https://github.com/reddit-archive/reddit/wiki/OAuth2
|
|
|
|
___
|
|
|
|
### Config Script
|
|
You can set your own constants at the top of the script
|
|
|
|
```javascript
|
|
// ===========================================
|
|
// ========== START CONFIG ZONE ==============
|
|
|
|
let refreshInt = 60 //refreshinterval as number in minutes
|
|
let showNotifyBadge = true //all home-widget sizes
|
|
let showUserTitle = false //medium- & large widget
|
|
let numberFormatting = 'de-DE' //For karma valuese. e.g.: en-EN, en-IN etc.
|
|
let widgetIcon = 'alienblue' //small- & medium widget; available icons: alienblue, black, classic, orange, roundorange, oldReddit, reddit, apollo;
|
|
let widgetType = 'karma' //karma or post
|
|
|
|
// =========== END CONFIG ZONE ================
|
|
//=============================================
|
|
|
|
```
|
|
<br>
|
|
|
|
### Widget Parameter
|
|
You can set ```Karma``` or ```Post``` individual in each Widgets.
|
|
'Karma' is not for the rectangular lockscreen widget available!
|
|
|
|
<br>
|
|
|
|
### Run Script In App
|
|
|
|
By running the scirpt In App it will present a menu with the following options.
|
|
_'Report Bug' Saves just a JSON with the reddit API response. You've to share it manually to get help!_
|
|
|
|
<img title="runInApp" src="Images/Screenshots/runInApp.png" width="250" align="center">
|
|
|
|
</br>
|
|
|
|
## On First Run
|
|
|
|
It will Downloads and Save the Following Symbols and a JavaScript Module at the directory "Reddit-Widget"
|
|
|
|
<img title="JavaScript module example icon" src="https://github.com/iamrbn/Mastodon-Widget/blob/ba5664d4d8205dd5480d4120a7162eb802e9f9cd/Images/jsModule.png" width="60" align="center"> <img title="karma" src="Images/karma.png" width="50" align="center"> <img title="cakedayApollo" src="Images/cakedayApollo.png" width="50" align="center"> <img title="cakedayConfetti" src="Images/cakedayConfetti.png" width="100" align="center"> <img title="snoovatar_ example" src="https://i.redd.it/snoovatar/avatars/d891afd6-32e8-4094-8e2b-34a7fedb879a.png" width="50" align="center"> <img title="oldReddit" src="Images/oldReddit.png" width="50" align="center"> <img title="classic" src="Images/classic.png" width="50" align="center"> <img title="orange" src="Images/orange.png" width="50" align="center">
|
|
<img title="black" src="Images/black.png" width="50" align="center"> <img title="alienblue" src="Images/alienblue.png" width="50" align="center"> <img title="redditLS" src="Images/redditLS.png" width="50" align="center"> <img title="ArrowsLS" src="Images/arrowsLS.png" width="50" align="center">
|
|
|
|
```
|
|
iCloud Drive/
|
|
├─ Scriptable/
|
|
│ ├─ Reddit-Widget/
|
|
│ │ ├─ redditModule.js
|
|
│ │ ├─ karma.png
|
|
│ │ ├─ cakedayApollo.png
|
|
│ │ ├─ cakedayConfetti.png
|
|
│ │ ├─ snoovatar_xxx.png
|
|
│ │ ├─ oldReddit.png
|
|
│ │ ├─ classic.png
|
|
│ │ ├─ orange.png
|
|
│ │ ├─ black.png
|
|
│ │ ├─ alienblue.png
|
|
│ │ ├─ arrowsLS.png
|
|
│ │ ├─ redditLS.png
|
|
---- alternative symbols ----
|
|
│ │ ├─ cakedayReddit.png
|
|
│ │ ├─ apollo.png
|
|
```
|
|
<img title="cakedayReddit" src="Images/cakedayReddit.png" width="50" align="center"> <img title="apollo" src="https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/a1/d8/a6/a1d8a63c-1534-2a04-b0fe-3de6e9c800b9/AppIcon-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-85-220.png/512x512bb.png" width="50" align="center">
|
|
|
|
|
|
<h2 style="font-size:1"
|
|
<p align="center" style="font-size:10vw">
|
|
<a href="https://github.com/iamrbn/Reddit-Widget/blob/main/README.md#reddit-user-widget-for-scriptable-"> ⬆️ Jump Back To Start </a>
|
|
</p>
|
|
</h2>
|
|
|
|
<p align="center">
|
|
<a href="https://reddit.com/user/iamrbn/">
|
|
<img title="Follow Me On Reddit @iamrbn" src="https://github.com/iamrbn/slack-status/blob/5fef0d438bd47bb8524e1b65679c8153ec30e165/Images/Badges/reddit_black_iamrbn.png" width="150"/>
|
|
</a>
|
|
<a href="https://twitter.com/iamrbn_/">
|
|
<img title="Follow Me On Twitter @iamrbn_" src="https://github.com/iamrbn/slack-status/blob/ae62582b728c2e2ad8ea6a55cc7729cf71bfaeab/Images/Badges/twitter_black.png" width="155"/>
|
|
</a>
|
|
<a href="https://mastodon.social/@iamrbn">
|
|
<img title="Follow Me On Mastodon iamrbn@mail.de@mastodon.socail" src="https://github.com/iamrbn/slack-status/blob/1e67e1ea969b791a36ebb71142ec8719594e1e8d/Images/Badges/mastodon_black.png" width="190"/>
|
|
</a>
|
|
</p>
|
|
|
|
|
|
[^1]:[Function](https://github.com/mvan231/Scriptable#updater-mechanism-code-example "GitHub Repo") is written by the amazing [@mvan231](https://twitter.com/mvan231 "Twitter") - Thx for your Support
|