Azure Screenshot Mask

# Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

## English

Copyright (c) 2025-2026 yamapan (aktsmm)

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License.

You are free to:

- **Share** — copy and redistribute the material in any medium or format
- **Adapt** — remix, transform, and build upon the material

Under the following terms:

- **Attribution** — You must give appropriate credit, provide a link to the
  license, and indicate if changes were made. You may do so in any reasonable manner,
  but not in any way that suggests the licensor endorses you or your use.

- **NonCommercial** — You may not use the material for commercial purposes.
  *(Please contact the author if you wish to use this material for commercial purposes.)*

- **ShareAlike** — If you remix, transform, or build upon the material, you must
  distribute your contributions under the same license as the original.

No additional restrictions — You may not apply legal terms or technological
measures that legally restrict others from doing anything the license permits.

**AI/ML Training Restriction** — Use of this content for AI/ML training, data
mining, or other analytical purposes is prohibited without explicit permission.

Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode

---

## 日本語

Copyright (c) 2025-2026 yamapan (aktsmm)

この作品はクリエイティブ・コモンズ 表示-非営利-継承 4.0 国際ライセンスの下に提供されています。

あなたは以下の条件に従う限り、自由に：

- **共有** — どのようなメディアやフォーマットでも資料を複製・再配布できます
- **翻案** — 資料をリミックス、変形、および加工することができます

以下の条件に従ってください：

- **表示** — あなたは適切なクレジットを表示し、ライセンスへのリンクを提供し、
  変更があったらその旨を示さなければなりません。これらは合理的であればどのような方法で
  行っても構いませんが、許諾者があなたやあなたの利用行為を支持していると示唆するような
  方法は除きます。

- **非営利** — あなたは営利目的でこの資料を利用してはなりません。
  （※商用利用をご希望の場合は、別途ご連絡ください。）

- **継承** — もしあなたがこの資料をリミックス、変形、または加工した場合、
  あなたはあなたの貢献部分を元の作品と同じライセンスの下で配布しなければなりません。

追加的な制約は課せません — あなたは、このライセンスが他の者に許諾することを法的に
制限するような法的条項や技術的手段を適用してはなりません。

**AI/MLトレーニング制限** — 本コンテンツをAI/MLモデルのトレーニング、データマイニング、
その他の解析目的での使用は明示的な許可なく禁止されています。

ライセンス全文: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.ja

---

## Special Permission for Microsoft Employees / Microsoft 社員向け特別許諾

### English

Microsoft Corporation employees are granted permission to use, copy, modify, and
distribute this material for any purpose within the scope of their employment
duties at Microsoft, including internal business use and customer-facing
activities, without the NonCommercial restriction of this license.

This special permission applies only to work performed as part of official
Microsoft business activities.

### 日本語

Microsoft Corporation の社員は、Microsoft での業務の範疇において、本資料を社内業務
および顧客対応を含むあらゆる目的で使用、複製、改変、配布することが許諾されます。
この場合、本ライセンスの「非営利」制限は適用されません。

この特別許諾は、Microsoft の公式な業務活動の一環として行われる作業にのみ適用されます。

---

## Disclaimer / 免責事項

### English

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR
A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

### 日本語

本ソフトウェアは「現状のまま」で提供され、明示または黙示を問わず、商品性、
特定目的への適合性、および権利非侵害についての保証を含むがこれに限定されない、
いかなる種類の保証も伴いません。作者または著作権者は、契約行為、不法行為、
またはそれ以外であろうと、ソフトウェアに起因または関連し、あるいはソフトウェアの
使用またはその他の扱いによって生じる一切の請求、損害、その他の責任について
責任を負いません。

"""Pixel-style mosaic for Azure Portal (or any) screenshots.

Use when publishing screenshots that contain environment-sensitive info such as:
- Top-right tenant name / user avatar strip (Azure Portal header)
- Subscription name or subscription ID values shown inside the page

By default, the script applies a pixel mosaic to the **top-right tenant strip**,
which has roughly the same shape across Azure Portal screenshots taken at the
standard 1912 px-wide viewport (last 320 px wide, top 44 px tall).

Additional regions can be specified with `--region L,T,R,B` (in pixels) and
the flag is repeatable.

Examples
--------
# Mask only the top-right tenant strip on every PNG in a folder (overwrite in place):
python scripts/mosaic-azure-screenshots.py images/qiita/some-article

# Single file, plus an extra region (e.g. subscription name row):
python scripts/mosaic-azure-screenshots.py images/qiita/.../overview.png --region 450,277,740,304

# Custom top-right strip size, or skip the default strip entirely:
python scripts/mosaic-azure-screenshots.py images/foo.png --topright-width 280 --topright-height 40
python scripts/mosaic-azure-screenshots.py images/foo.png --no-topright --region 100,200,500,240

Notes
-----
- Files are overwritten in place. Use `--backup` to keep `<name>.bak.png` copies.
- Body-content region coordinates depend on the page layout, so they stay
  article-specific. Capture them once per page and pass via `--region` flags.
"""
from __future__ import annotations

import argparse
import sys
from pathlib import Path

from PIL import Image


def pixelate(img: Image.Image, box: tuple[int, int, int, int], block: int = 14) -> None:
    """Mosaic the given (l, t, r, b) box in place by downscaling then upscaling."""
    l, t, r, b = box
    iw, ih = img.size
    l, t = max(0, l), max(0, t)
    r, b = min(iw, r), min(ih, b)
    if r - l <= 0 or b - t <= 0:
        return
    region = img.crop((l, t, r, b))
    sw = max(1, (r - l) // block)
    sh = max(1, (b - t) // block)
    small = region.resize((sw, sh), Image.NEAREST)
    region = small.resize((r - l, b - t), Image.NEAREST)
    img.paste(region, (l, t))


def parse_region(spec: str) -> tuple[int, int, int, int]:
    parts = [int(p.strip()) for p in spec.split(",")]
    if len(parts) != 4:
        raise argparse.ArgumentTypeError(f"--region expects L,T,R,B (got: {spec!r})")
    return tuple(parts)  # type: ignore[return-value]


def iter_targets(path: Path) -> list[Path]:
    if path.is_file():
        return [path]
    if path.is_dir():
        return sorted(path.glob("*.png"))
    raise FileNotFoundError(path)


def main(argv: list[str] | None = None) -> int:
    ap = argparse.ArgumentParser(description="Mosaic env-sensitive areas of screenshots.")
    ap.add_argument("path", type=Path, help="PNG file or directory of PNGs.")
    ap.add_argument(
        "--region",
        action="append",
        type=parse_region,
        default=[],
        help="Extra mosaic region as L,T,R,B (pixel coords). Repeatable.",
    )
    ap.add_argument("--topright-width", type=int, default=320, help="Top-right strip width.")
    ap.add_argument("--topright-height", type=int, default=44, help="Top-right strip height.")
    ap.add_argument("--no-topright", action="store_true", help="Skip default top-right strip.")
    ap.add_argument("--block", type=int, default=14, help="Mosaic block size (px).")
    ap.add_argument("--backup", action="store_true", help="Write <name>.bak.png before overwrite.")
    args = ap.parse_args(argv)

    targets = iter_targets(args.path)
    if not targets:
        print(f"no PNG found at: {args.path}", file=sys.stderr)
        return 1

    for p in targets:
        with Image.open(p) as src:
            img = src.convert("RGB")
            W, H = img.size
        regions = list(args.region)
        if not args.no_topright:
            regions.append((W - args.topright_width, 0, W, args.topright_height))
        if not regions:
            print(f"skip (no regions): {p.name}")
            continue
        if args.backup:
            bak = p.with_suffix(".bak.png")
            if not bak.exists():
                img.save(bak)
        for region in regions:
            pixelate(img, region, block=args.block)
        img.save(p)
        print(f"masked: {p.name} ({W}x{H}) regions={len(regions)}")

    return 0


if __name__ == "__main__":
    raise SystemExit(main())