diff --git a/README.md b/README.md new file mode 100644 index 0000000..93130f2 --- /dev/null +++ b/README.md @@ -0,0 +1,104 @@ +# kyocera-fs-1x2x-mfp-gdi + +Kyocera GDI printer driver package for Arch Linux and CUPS. + +This project packages the Linux GDI driver files for a group of legacy Kyocera FS-1xxx printers and installs them in the standard CUPS locations. The package is distributed as an Arch Linux `PKGBUILD`. + +## Supported printers + +The package currently installs PPD files for: + +- Kyocera FS-1020MFP +- Kyocera FS-1025MFP +- Kyocera FS-1040 +- Kyocera FS-1060DN +- Kyocera FS-1120MFP +- Kyocera FS-1125MFP + +All of these models use the bundled `rastertokpsl` CUPS filter. + +## Requirements + +- Arch Linux or another Arch-compatible environment with `makepkg` +- `cups` +- `x86_64` + +The package declares `cups` as a runtime dependency and is built for `x86_64`. + +## Build and install + +Clone the repository, then build the package with `makepkg`: + +```bash +git clone +cd kyocera-fs-1x2x-mfp-gdi +makepkg -si +``` + +After installation, restart CUPS if necessary: + +```bash +sudo systemctl restart cups +``` + +The installed PPD files are placed under: + +```text +/usr/share/cups/model/Kyocera/ +``` + +The CUPS filter is installed as: + +```text +/usr/lib/cups/filter/rastertokpsl +``` + +## Printer setup + +Add the printer through your desktop's printer settings or through the CUPS web interface at `http://localhost:631/`. + +When selecting a driver manually, use the PPD matching the exact printer model, for example: + +```text +/usr/share/cups/model/Kyocera/Kyocera_FS-1040GDI.ppd +``` + +## Package details + +Current package version: + +```text +1.1203-1 +``` + +The PKGBUILD fetches the driver archive from Kyocera Document Solutions and extracts the Russian 64-bit driver payload before installing the required PPD files and `rastertokpsl` filter. + +Upstream archive: + +```text +https://www.kyoceradocumentsolutions.ru/content/dam/download-center-cf/ru/drivers/all/LinuxDrv_1_1203_FS_1x2xMFP_zip.download.zip +``` + +## Files installed + +```text +/usr/share/cups/model/Kyocera/ +├── Kyocera_FS-1020MFPGDI.ppd +├── Kyocera_FS-1025MFPGDI.ppd +├── Kyocera_FS-1040GDI.ppd +├── Kyocera_FS-1060DNGDI.ppd +├── Kyocera_FS-1120MFPGDI.ppd +└── Kyocera_FS-1125MFPGDI.ppd + +/usr/lib/cups/filter/rastertokpsl +``` + +## Licensing + +The repository's packaging metadata is dedicated to the public under **CC0-1.0**. See [`LICENSES/CC0-1.0.txt`](LICENSES/CC0-1.0.txt) and [`PKGBUILD.license`](PKGBUILD.license). + +This does not change the copyright or licensing terms of the Kyocera driver files obtained from the upstream archive. The upstream driver components remain subject to their respective terms. + +## Source and attribution + +The packaged driver originates from Kyocera Document Solutions. This repository provides the Arch Linux packaging needed to install the legacy Linux GDI driver through CUPS. diff --git a/README.ru.md b/README.ru.md new file mode 100644 index 0000000..3c381ab --- /dev/null +++ b/README.ru.md @@ -0,0 +1,99 @@ +# kyocera-fs-1x2x-mfp-gdi + +Пакет GDI-драйвера принтеров Kyocera для Arch Linux и CUPS. + +Проект содержит Arch Linux `PKGBUILD`, который загружает оригинальный Linux GDI-драйвер Kyocera для ряда устаревших принтеров серии FS-1xxx и устанавливает необходимые файлы в стандартные каталоги CUPS. + +### Поддерживаемые принтеры + +В пакет входят PPD-файлы для следующих моделей: + +- Kyocera FS-1020MFP +- Kyocera FS-1025MFP +- Kyocera FS-1040 +- Kyocera FS-1060DN +- Kyocera FS-1120MFP +- Kyocera FS-1125MFP + +Для поддерживаемых моделей используется входящий в драйвер фильтр CUPS `rastertokpsl`. + +### Требования + +- Arch Linux или совместимая система с `makepkg` +- `cups` +- архитектура `x86_64` + +`cups` указан в качестве зависимости пакета, сборка рассчитана на `x86_64`. + +### Сборка и установка + +Склонируйте репозиторий и соберите пакет с помощью `makepkg`: + +```bash +git clone +cd kyocera-fs-1x2x-mfp-gdi +makepkg -si +``` + +При необходимости перезапустите CUPS: + +```bash +sudo systemctl restart cups +``` + +После установки файлы размещаются в следующих каталогах: + +```text +/usr/share/cups/model/Kyocera/ +/usr/lib/cups/filter/rastertokpsl +``` + +### Настройка принтера + +Добавьте принтер через настройки печати рабочего окружения или через веб-интерфейс CUPS: `http://localhost:631/`. + +При ручном выборе драйвера укажите PPD-файл, соответствующий точной модели принтера. Например: + +```text +/usr/share/cups/model/Kyocera/Kyocera_FS-1040GDI.ppd +``` + +### Информация о пакете + +Текущая версия пакета: + +```text +1.1203-1 +``` + +`PKGBUILD` загружает архив Linux-драйвера с сайта Kyocera Document Solutions, извлекает 64-битную русскую версию драйвера и устанавливает необходимые PPD-файлы и фильтр `rastertokpsl`. + +Архив исходного драйвера: + +```text +https://www.kyoceradocumentsolutions.ru/content/dam/download-center-cf/ru/drivers/all/LinuxDrv_1_1203_FS_1x2xMFP_zip.download.zip +``` + +### Установленные файлы + +```text +/usr/share/cups/model/Kyocera/ +├── Kyocera_FS-1020MFPGDI.ppd +├── Kyocera_FS-1025MFPGDI.ppd +├── Kyocera_FS-1040GDI.ppd +├── Kyocera_FS-1060DNGDI.ppd +├── Kyocera_FS-1120MFPGDI.ppd +└── Kyocera_FS-1125MFPGDI.ppd + +/usr/lib/cups/filter/rastertokpsl +``` + +### Лицензирование + +Метаданные упаковки этого репозитория посвящены общественному достоянию по лицензии **CC0-1.0**. См. [`LICENSES/CC0-1.0.txt`](LICENSES/CC0-1.0.txt) и [`PKGBUILD.license`](PKGBUILD.license). + +Это не изменяет условия авторских прав и лицензирования файлов драйвера Kyocera, полученных из исходного архива. Компоненты оригинального драйвера продолжают распространяться на условиях, применимых к ним. + +### Источник + +Исходный драйвер предоставлен Kyocera Document Solutions. Этот репозиторий содержит Arch Linux-упаковку, необходимую для установки устаревшего Linux GDI-драйвера через CUPS.