Added files

README.md

@@ -1,2 +1,97 @@
-# ccd2cue
-Bruh, just a ccd -> cue converter
+# CCD2CUE - Конвертер CCD в CUE файлы
+
+## Описание
+
+`ccd2cue` - Утилита для преобразования файлов образов CD/DVD в формате CCD (CloneCD) в CUE-файлы. 
+
+## Особенности
+
+- Конвертирует CCD-файлы в CUE-формат
+- Автоматически определяет файлы образов (.img, .bin, .iso)
+- Поддерживает различные типы треков (данные и аудио)
+- Корректно обрабатывает временные метки и индексы треков
+- Не требует внешних зависимостей (кроме стандартной библиотеки C)
+
+## Установка и компиляция
+
+### Требования
+- Компилятор GCC
+- Стандартная библиотека C
+- POSIX-совместимая операционная система
+
+### Компиляция
+
+```bash
+gcc -o ccd2cue ccd2cue.c
+```
+
+## Использование
+
+### Базовый синтаксис
+
+```bash
+ccd2cue -c <файл.ccd>
+```
+
+### Параметры командной строки
+
+| Параметр | Описание |
+|----------|----------|
+| `-c <файл>` | Обязательный параметр. Указывает путь к входному CCD-файлу |
+
+### Примеры использования
+
+```bash
+# Конвертировать файл example.ccd
+./ccd2cue -c example.ccd
+
+# Конвертировать файл в другом каталоге
+./ccd2cue -c /path/to/disc.ccd
+```
+
+## Входные и выходные файлы
+
+### Входные файлы
+- **CCD-файл**: Файл с расширением `.ccd`, содержащий метаданные о структуре диска
+- **Файл образа**: Автоматически определяется по расширениям:
+  - `.img`
+  - `.bin` 
+  - `.iso`
+
+### Выходные файлы
+- **CUE-файл**: Создается с тем же именем, что и CCD-файл, но с расширением `.cue`
+
+### Пример структуры файлов
+
+```
+директория_проекта/
+├── disc.ccd      # Входной файл
+├── disc.img      # Файл образа (автоопределение)
+└── disc.cue      # Выходной файл (создается программой)
+```
+
+## Форматы поддерживаемых треков
+
+Программа поддерживает два основных типа треков:
+
+| Тип трека | Описание | CUE-формат |
+|-----------|----------|------------|
+| Данные | Треки с компьютерными данными | `MODE1/2352` |
+| Аудио | Аудио треки | `AUDIO` |
+
+## Обработка временных меток
+
+Программа автоматически корректирует временные метки:
+- Вычитает 2 секунды из времени каждого трека
+- Корректно обрабатывает переходы через минуту
+- Сохраняет точность до кадров (frames)
+
+## Коды возврата
+
+| Код | Значение |
+|-----|----------|
+| `0` | Успешное выполнение |
+| `1` | Ошибка: не указан CCD-файл |
+| `2` | Ошибка: не удалось прочитать CCD-файл |
+| `3` | Ошибка: не найден файл образа |
+