No description

Find a file

oiupoyt 6cb649fb8c Update README to be clean and minimal		2026-09-26 21:54:52 +05:30
src	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
tests	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
.env.example	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
.gitignore	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
Cargo.toml	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
config.example.toml	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
config.toml	Initial commit: insta-note-clock implementation with tests	2026-09-26 20:41:21 +05:30
README.md	Update README to be clean and minimal	2026-09-26 21:54:52 +05:30

README.md

🕒 insta-note-clock

A lightweight Rust CLI daemon that updates your Instagram Note with the current time at a configurable, safe interval.

⚠️ Disclaimer: Instagram has no public API for Notes. This tool interacts with private mobile endpoints, which violates Instagram's Terms of Service. Frequent updates risk rate limits (HTTP 429) or account suspension. Default interval is 120s with exponential backoff. Use at your own risk.

Quick Start

1. Build

cargo build --release

2. Authenticate

# Option A: Direct session cookie import (recommended)
cargo run -- login --session-id "YOUR_SESSION_ID" --user-id "YOUR_DS_USER_ID"

# Option B: Interactive login (supports 2FA)
cargo run -- login

Session data will be stored securely in session.json.

3. Run

# Test run without hitting Instagram
cargo run -- --dry-run once

# Update once and exit
cargo run -- once

# Run continuous sync loop
cargo run -- run

Configuration (`config.toml`)

[instagram]
session_file = "./session.json"
timezone = "Asia/Kolkata"

[note]
interval_seconds = 120    # Minimum recommended: 120s
time_format = "%H:%M"     # strftime syntax
prefix = "🕒 "
suffix = ""
max_requests_per_hour = 30

Environment variables with prefix INSTA_ (e.g. INSTA_NOTE__INTERVAL_SECONDS=120) are also supported.