Skip to content
프로젝트

loui89/metaspin has 32 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and +1 in 15 days. Last checked 2026-11-21 09:06 UTC. Last push 2026-08-30.

이 수치를 측정하는 방법

측정된 스타 증가

in 24h
0
in 7 days
0
in 15 days
+1
in 1 month
기록 수집 중

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

소개

Convierte cualquier video al formato de las Ray-Ban Meta para activar Spin View en Instagram

창작 및 미디어

README.md

Original

metaspin

Español

Rewrites any video into a .MOV carrying the same QuickTime structure that Ray-Ban Meta Smart Glasses 2 produce, so Instagram treats it as glasses footage and enables Spin View.

You do not need the glasses. Every atom is generated from spec, so no serial number or device identifier from anyone else travels inside your files.


What was found

Instagram decides whether a video came from Meta glasses by reading the file structure, not the pixels. Four approaches were tested against a real account:

Test Approach Result
A Add the Meta metadata tags only fails
B Metadata plus reducing to two tracks fails
C Metadata plus matching codec, resolution and color fails
D Rebuild the full QuickTime structure works

Test D was confirmed on two unrelated sources: an iPhone HDR recording and an edited H.264 MP4. Where the footage came from does not matter.

Comparing a working D file against a genuine glasses recording turned up something more useful. They differed in six structural points and Instagram accepted it anyway. The check is far looser than a strict structural clone. This tool generates only what both files share.

Reproduced

  • QuickTime container, qt brand, ftyp / wide / mdat / moov order
  • meta atom as a direct child of moov, not nested inside udta
  • com.apple.quicktime.* metadata with the device values
  • Core Media Video, Core Media Audio and Core Media Data Handler handlers
  • tapt atom with clef, prof and enof
  • HEVC Main tagged hvc1 at 1376 x 1840, 30 fps
  • Movie timescale 48000, video timescale 600
  • colr nclc 9/18/9, meaning BT.2020 with HLG transfer
  • AAC LC at 48 kHz stereo
  • Exactly two tracks

Ruled out

The amve atom was suspected of being the trigger. It is not: the genuine glasses recording does not contain it, and a file that did contain it worked anyway. The same goes for chrm, sgpd, sbgp, cslg, and atom ordering inside stbl.


Install

1. Python

macOS ships it once Apple's command line tools are installed. If the program says it is missing, open Terminal and run:

xcode-select --install

2. ffmpeg

Download it from ffmpeg.martin-riedl.de. Pick your Mac type and use the installer, which is signed and notarized by Apple, so Gatekeeper will not fight you. You need both ffmpeg and ffprobe.

3. This tool

git clone https://github.com/loui89/metaspin.git
cd metaspin

Downloading the ZIP works too, but macOS quarantines anything that arrives that way and strips the executable bit. Cloning avoids both problems.


Use

Drop your videos into the entrada folder and double click Convertir.command. Results land in salida.

If you downloaded the ZIP instead of cloning, macOS will raise two objections. Fix both at once, adjusting the path to wherever your folder is. The easy way to type a path is to drag the file from Finder into the Terminal window:

chmod +x /path/to/metaspin/Convertir.command
xattr -d com.apple.quarantine /path/to/metaspin/Convertir.command

The first restores the executable bit lost during ZIP extraction. The second removes the quarantine flag macOS attaches to downloads. Neither prints anything on success.

Skipping the launcher

Running the script directly works just as well and avoids all of the above:

python3 metaspin.py                       # convert the entrada folder
python3 metaspin.py clip.mp4 ./salida     # convert a single file

Getting it onto your phone

The file breaks if it passes through anything that rewrites it.

  1. AirDrop the .MOV to your iPhone. Not WhatsApp, Telegram or Drive.
  2. Save to Photos.
  3. Post to Instagram normally.

Notes

  • Video is cropped to 1376 x 1840 vertical, matching what the glasses record. Landscape sources will lose their sides.
  • If your source is already BT.2020 HLG, such as an iPhone shooting HDR, the color is left alone. Converting twice flattens contrast.
  • All original metadata is stripped, GPS coordinates included.
  • Each output carries a freshly generated identifier.
  • Duration is unconstrained. There is no eight second limit.

Disclaimer

This documents the observed behavior of a third party product. Instagram can change it at any time and this may stop working without notice.

License

MIT