Skip to content

README.md

Latest commit

 

History

History
191 lines (145 loc) · 9.58 KB

README.md

File metadata and controls

191 lines (145 loc) · 9.58 KB

PERIPETEIA // BATCH_MANAGER

Версия: 7.3.0
Файл: FastStoneManager.ps1
Платформа: Windows PowerShell 5.1+

📖 Описание

PERIPETEIA — это утилита управления файлами на базе PowerShell с графическим интерфейсом (GUI), созданная для оптимизации процесса отбора (culling) и сортировки фотографий.

Инструмент автоматизирует рутинные задачи: перемещение файлов между папками и запуск слайд-шоу в FastStone Image Viewer с заданным интервалом. Интерфейс выполнен в стиле одноимённой игры PERIPETEIA.

Интерфейс программы

✨ Возможности

Основные функции

  • Автоматизация FastStone: Запуск слайд-шоу в папке «На редактирование» с автоматической настройкой интервала через эмуляцию нажатий клавиш.
  • Трехуровневая система папок:
    • Source (Исходник) → Dest (Редактирование)
    • Dest (Редактирование) → Source (Возврат)
    • Dest (Редактирование) → Dump (Удаление/Корзина)
  • Настройки на лету: Изменение интервала слайд-шоу и количества перемещаемых файлов прямо в интерфейсе.
  • Логирование: Все действия записываются в файл лога и дублируются в консоль интерфейса.
  • Сохранение конфигурации: Автоматическое запоминание путей и последних использованных настроек.

А также другие параметры:

  • Пути к исходной, рабочей и архивной папкам
  • Путь к исполняемому файлу FastStone Image Viewer
  • Настройки шрифта (имя и размер)
  • Подтверждение операции удаления (Yes/No)
  • Сортировка файлов по имени
  • Путь к GIF-анимации для интерфейса

🛠 Требования

Компонент Версия / Примечание
ОС Windows 10/11
PowerShell 5.1 или выше (встроен в Windows)
FastStone Image Viewer Любая версия (требуется установка)

Пути к FastStone по умолчанию:

  • C:\Program Files\FastStone Image Viewer\FSViewer.exe
  • C:\Program Files (x86)\FastStone Image Viewer\FSViewer.exe

🚀 Установка и Запуск

Быстрый старт

  1. Скачайте файлы проекта в одну папку.
  2. Убедитесь, что у вас установлен FastStone Image Viewer.
  3. Запустите файл FastStoneManager.ink

Если скрипт не запускается

По умолчанию Windows блокирует выполнение скриптов. Разрешите выполнение командой: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

⚙️ Настройка (Конфигурация)

При первом запуске скрипт автоматически создаст:

  • Файл конфигурации: FastStoneManager.cfg
  • Файл лога: FastStoneManager.log
  • Папки (при отсутствии путей в .cfg) в Мои рисунки (Pictures):
    • ...\Pictures\ToSort — Source (исходные файлы)
    • ...\Pictures\ToEdit — Dest (файлы на редактирование)
    • ...\Pictures\Dump — Dump (удалённые файлы)

Редактирование конфигурации

Вы можете изменить пути в файле FastStoneManager.cfg вручную:

# PERIPETEIA Configuration
BuildVersion=7.3.0
SourceFolder=C:\Pictures\ToSort
DestFolder=C:\Pictures\ToEdit
DumpFolder=C:\Pictures\Dump
FastStoneExe=C:\Program Files\FastStone Image Viewer\FSViewer.exe
GifPath=2ixcRP-2571084192.gif
LastSeconds=90
LastCount=10
ConfirmDelete=true
SortBy=Name
FontName=Consolas
FontSize=11

🎮 Использование

Интерфейс управляется с помощью мыши или клавиатуры.

Горячие клавиши

Клавиша Действие
↑ / ↓ Навигация по списку операций
ENTER Выполнить операцию / Перейти к вводу параметров
ESC Закрыть приложение
TAB Переключение между полями ввода

Операции (Operations)

Используйте стрелки ↑ / ↓ для выбора операции и ENTER для подтверждения.

# Операция Описание Параметр
01 VIEW_SLIDESHOW Запускает FastStone в папке ToEdit SLIDE [sec] — интервал смены кадров
02 MOVE Перемещает файлы из ToSort в ToEdit COUNT — количество файлов
03 REVERT Возвращает файлы из ToEdit в ToSort COUNT — количество файлов
04 DELETE Перемещает файлы из ToEdit в Dump COUNT — количество файлов

Рабочий процесс (Workflow)

┌──────────────┐    MOVE     ┌──────────────┐    DELETE   ┌──────────────┐
│    Source    │ ──────────> │     Dest     │ ──────────> │     Dump     │
│   (ToSort)   │             │   (ToEdit)   │             │   (Archive)  │
└──────────────┘             └──────────────┘             └──────────────┘
       ▲                          │
       │         REVERT           │
       └──────────────────────────┘
  1. Загрузите новые фотографии в папку Source (ToSort)
  2. Выберите операцию 02_MOVE, нажмите Enter, и укажите количество файлов (например, 5), Enter
  3. Выберите операцию 01_VIEW_SLIDESHOW для просмотра, Enter
  4. Запустится FastStone в режиме Slideshow с выбранными параметрами
  5. После завершения работы вернитесь в PERIPETEIA:
    • 04_DELETE — для удаления (переместит в Dump)
    • 03_REVERT — если нужно вернуть в исходную папку
  6. Повторите процесс

📂 Структура файлов

PERIPETEIA/
├── FastStoneManager.ps1      # Основной скрипт
├── FastStoneManager.bat      # Ярлык для запуска
├── FastStoneManager.cfg      # Файл конфигурации (создаётся автоматически)
├── FastStoneManager.log      # Журнал действий (создаётся автоматически)
├── FastStoneManager.ico      # Иконка приложения
├── readme/
│   ├── interface.png         # Скриншот интерфейса
│   └── README.md             # Этот файл
└── README.md

🐛 Решение проблем

Проблема Решение
Скрипт не запускается Проверьте политику выполнения PowerShell (см. выше)
FastStone не открывается Укажите правильный путь в FastStoneManager.cfg
Окно не перемещается Убедитесь, что захват происходит за заголовок окна
Ошибка «Path validation failed» Проверьте существование указанных папок в конфиге

⚠️ Disclaimer / Отказ от ответственности

⚖️ Fan Project Notice

This tool is a fan-made utility and is not affiliated with, endorsed by, or connected to the official creators of the game "PERIPETEIA".

  • Name & Assets: All rights to the name "PERIPETEIA", the logo, and the visual assets (GIF/Icons) used in the interface belong to their respective owners. This project uses them under fair use for a fan tool.
  • No Ownership Claim: The author of this script does not claim any ownership over the game's intellectual property.
  • Usage: This script is provided "as is" for educational and personal workflow optimization purposes. Use at your own risk.
  • Data Safety: Always backup your photos before batch operations. The author is not responsible for any data loss.

📄 Лицензия

Этот проект распространяется как есть (AS IS) для личного использования.

Developed with ❤️ and PowerShell