You are viewing a potentially older version of this package. View all versions.
Pirateskin-StoryFrame-1.0.0 icon

StoryFrame

9:16 Instagram Story frame overlay for lining up replay editor shots.

Date uploaded a week ago
Version 1.0.0
Download link Pirateskin-StoryFrame-1.0.0.zip
Downloads 142
Dependency string Pirateskin-StoryFrame-1.0.0

README

ClipFrame

A simple 9:16 framing overlay for the replay editor. Line up your shot so the clip fits a phone screen and Instagram Videos and Story exactly, with nothing important hidden behind the Story UI.

What it does

  • Draws a centred 9:16 frame over your screen and dims everything outside it, so you can see exactly what will end up in the clip.
  • Shows the Instagram Story safe zones: the red bands at the top and bottom mark where the profile bar and reply bar cover the video.
  • Optional rule-of-thirds grid and centre cross for composing the shot.
  • Scales to any resolution and keeps the exact 9:16 ratio.

It only draws a guide on your screen. It does not change the game or what gets recorded.

Install

  1. Download the zip and unzip it into your ReSkate Mods folder so you end up with Mods\storyframe\.
  2. ReSkate picks new plugins up automatically. If it does not show, restart the game.

Controls

Key Action
F4 Show / hide the overlay
F3 Cycle the guides

The guide modes cycle in this order:

  1. Frame only
  2. Frame + safe zones (default)
  3. Frame + safe zones + thirds grid
  4. Frame + safe zones + thirds grid + centre cross

Both keys can be rebound on ReSkate's Binds page.

How to use it

  1. Open the replay editor and press F4.
  2. Move the camera so your skater sits inside the bright frame, ideally in the middle band between the two red zones.
  3. Keep the trick, the board and any text or tags out of the red zones.
  4. Press F4 again to hide the overlay before you record.

Tuning

Open plugin/main.lua in any text editor. The values at the top control the layout:

  • TOP_SAFE (default 0.14): share of the frame height covered by Instagram's top bar.
  • BOTTOM_SAFE (default 0.20): share covered by the reply bar at the bottom.
  • ASPECT (default 9 / 16): change it to 4 / 5 for a feed post or 1 / 1 for a square.

Troubleshooting

  • Nothing shows: check logs/ReSkate.log for lines starting with [storyframe].
  • F3 or F4 does nothing: another mod or the replay editor may be using the key. Rebind it on the Binds page.
  • Safe zones look off: Instagram changes its layout from time to time. Adjust TOP_SAFE and BOTTOM_SAFE to taste.

Credits

Made by Leigh.

CHANGELOG

Changelog

1.2.0

  • Key legend on both sides of the frame showing every key and all its options, with the current choice highlighted.
  • If the frame leaves no room on the sides (e.g. 16:9 on a 16:9 screen), the legend sits inside the frame's top-left corner instead.
  • Turn the legend off with SHOW_KEYS = false in plugin/main.lua.

1.1.0

  • Lighter dimming outside the frame so the replay editor UI stays readable. New F5 key cycles Light (default), Medium, Dark and Off.
  • New F2 key cycles formats: Story 9:16, Reel / TikTok 9:16, Portrait 4:5, Square 1:1, Classic 4:3 and Wide 16:9.
  • Reel / TikTok format has its own safe zones, including the button column on the right.
  • On-screen readout shows the format, frame size in pixels, guides and dim level after any change.
  • Small ratio badge in the corner of the frame.
  • Frame border now draws inside the frame, so it stays visible when the frame fills the screen.

1.0.0

  • First release: 9:16 Story frame, safe zones, thirds grid, centre cross.