Это проект интерактивного каталога игр и программного обеспечения для советских 16‑битных компьютеров семейства «Электроника БК‑0010/БК‑0011М», а также встроенный web‑эмулятор БК в подкаталоге emulator/.

Посмотреть каталог в действии: GitHub Pages и PDP-11.RU.

Посмотреть эмулятор в действии: GitHub Pages и PDP-11.RU.

• ✅ Каталог игр, демо и прикладного/системного ПО для Электроника БК‑0010/БК‑0011М
• ✅ Развитый поиск и фильтрация по каталогу
• ✅ Просмотр карточек с описаниями и скриншотами
• ✅ Возможность скачивать архивы с файлами игр/программ
• ✅ Если архив содержит .BIN/.OVL файлы - есть возможность их онлайн-проигрывания (конвертер BIN2WAV)
• ✅ Встроенный эмулятор БК (HTML5 + JavaScript) в каталоге emulator/
• ✅ Отсутствие рекламы
• ✅ Лицензия GNU GPL v3 для исходного кода

Проект представляет собой статический сайт и не требует сборки.

Для старта достаточно поднять простой локальный сервер в корне проекта:

• Через Python:

  cd bk-catalog
  python -m http.server 8000

  После этого откройте в браузере http://localhost:8000/index.html.

• Через любой другой static‑server (например, serve, http-server и т.п.) — подойдёт любой способ, который раздаёт файлы из корня репозитория.

Обзор основных директорий проекта:

bk-catalog/
├── index.html                    # Главная страница каталога
├── content/                      # Данные каталога
│   ├── games.csv                 # Игры
│   ├── software.csv              # Прикладное/системное ПО и утилиты
│   ├── demoscene.csv             # Демосцена
│   └── bkpress.md                # Тексты/статьи о БК
├── scripts/                      # JavaScript-логика каталога (фильтры, рендеринг и т.п.)
├── styles/                       # Стили оформления
├── images/                       # Фоновые и служебные изображения интерфейса
├── bk_games_files/               # Архивы с играми для БК
├── bk_files/                     # Архивы прикладного/системного ПО
├── bk_games_screenshots/         # Скриншоты игр (полный размер)
├── bk_games_small_screenshots/   # Уменьшенные скриншоты игр
├── bk_screenshots/               # Скриншоты прикладного/системного ПО
├── bk_small_screenshots/         # Уменьшенные скриншоты прикладного/системного ПО
├── models/                       # Изображения/модели компьютеров семейства БК
├── emulator/                     # Web-эмулятор БК-0010/БК-0011М
├── fonts/                        # Шрифты, используемые в интерфейсе
├── favicon.ico                   # Иконка сайта
└── LICENSE                       # Лицензия (GNU GPL v3)

Подробнее о структуре и возможностях самого эмулятора смотрите в emulator/README.md.

• Основной интерфейс каталога реализован в index.html и скриптах из каталога scripts/.
• Данные берутся из CSV‑файлов в каталоге content/.
• Поддерживается группировка записей по типам (игры, ПО, демо‑сцена и т.п.).
• В интерфейсе могут быть доступны фильтры и поиск по нескольким полям (тип, жанр, год и т.д.) — их реализация хранится в JavaScript‑модулях в scripts/.

• Архивы с играми и программами для БК хранятся в bk_games_files/ и bk_files/.
• Скриншоты для карточек и превью лежат в bk_games_screenshots/, bk_games_small_screenshots/, bk_screenshots/ и bk_small_screenshots/.
• При необходимости новые записи добавляются в соответствующие CSV‑файлы в каталоге content/ с указанием путей до файлов и изображений.

Для запуска игр и программ прямо из браузера используется web‑эмулятор в каталоге emulator/:

• Эмулятор описан в отдельном файле emulator/README.md.
• В каталоге emulator/ находятся HTML‑страница bk-emulator.html, ресурсы, образы и исходники JS‑эмуляции БК.
• Каталог может перенаправлять пользователя в эмулятор с выбранным образом/файлом.

Проект не использует сборщики и фреймворки — это набор статических ресурсов (HTML/CSS/JS).

Основные точки расширения:

• Обновление и дополнение CSV‑файлов в каталоге content/.
• Доработка скриптов каталога в scripts/ (логика фильтров, рендеринг карточек, deeplink‑ссылки на эмулятор и т.д.).
• Правки стилей в styles/ и графики в images/ и каталогах со скриншотами.
• Модификация и развитие эмулятора в каталоге emulator/ (см. отдельный README.md внутри него).

Если вы хотите предложить изменения:

1. Сделайте форк репозитория.
2. Создайте ветку с говорящим названием.
3. Внесите изменения и добавьте короткое описание в комментариях.
4. Отправьте pull request.

Исходный код проекта распространяется по лицензии GNU General Public License v3. Полный текст лицензии приведён в файле LICENSE в корне репозитория.

Убедитесь, что ваш вклад совместим с условиями GPLv3.

(с) 2025-2026 by Ivan "VDM" Kalininskiy

• Telegram: @VanDamM

По общим вопросам по эмулятору и его устройству также смотрите emulator/README.md.