Skip to content

avvmoto/visual-sequence-renamer

Repository files navigation

ならべて連番リネーマー(Visual Sequence Renamer)

renamer

無料のフリーソフトです。ソースコードは公開された オープンソース(MIT License) であり、利用・改変・再配布はライセンスの範囲内で自由です。

ドラッグ&ドロップでファイルを並べ替え、指定した順で 001_元の名前.ext 形式に連番リネームするデスクトップアプリです。macOS / Windows 向け(PySide6 / Qt6)。

名前について: 画面上で並べた順に連番でリネームする体験を表す ならべて連番リネーマー、英語名 Visual Sequence Renamer です。Python パッケージ名およびコマンドは短い renamer のままです(pip install renamer / uv run renamer など)。Windows 向け PyInstaller 成果物は VisualSequenceRenamer.exe(単一ファイル)。GitHub Release / CI Artifact では VisualSequenceRenamer.zip(中身は exe のみ)を配布します。

機能

  • ファイルのドラッグ&ドロップでリストに追加
  • 画像はサムネイル表示、それ以外は形式に応じたアイコン
  • リスト内をドラッグして並べ替え(連番の順序に直結)
  • 出力はデフォルトで renamed_YYYYMMDD_HHMM フォルダ、または任意の出力先を指定可能
  • サムネイル生成・リネームはバックグラウンド処理(UI をブロックしにくい)

詳細な仕様は spec.md を参照してください。

必要環境

  • Python 3.10 以上
  • uv(推奨)または pip

セットアップと起動

# リポジトリをクローンしてプロジェクトルートに移動したうえで
uv sync
uv run renamer

開発用に依存だけ入れる場合(Lint / テスト):

uv sync --group dev

PyInstaller で Windows 用 exe を試す場合は、さらに build グループpyproject.toml[dependency-groups] build)を有効にしてください。

uv sync --group dev --group build
# またはすべてのグループ: uv sync --all-groups

開発

用途 コマンド
テスト uv run pytest
Lint uv run ruff check .
整形 uv run ruff format .
型チェック uv run mypy

Windows 向けビルドはリポジトリ直下の VisualSequenceRenamer.speconefile・未使用 Qt モジュール除外)と .github/workflows/build.yml を参照してください。ローカル例: uv sync --group build のうえ uv run pyinstaller --noconfirm VisualSequenceRenamer.specdist/VisualSequenceRenamer.exe

ライセンス

MIT License

再利用・改変・商用利用を含め、ソフトウェアおよびドキュメントを自由に利用できます。利用は自己責任で、作者は保証しません。不具合報告や改善のプルリクエストは歓迎します(保証はありません)。

English summary

Visual Sequence Renamer (Japanese: ならべて連番リネーマー) is a free cross-platform (macOS / Windows) desktop app built with PySide6. Drop files, reorder them, then batch-rename to 001_originalname.ext in the same folder. Open source under the MIT License — use freely for any purpose. The installable Python package / CLI command remains renamer for brevity. Windows releases ship VisualSequenceRenamer.zip containing a single VisualSequenceRenamer.exe.

About

The most intuitive visual file renamer. Drag, sort, and rename images into sequential numbers in seconds.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages