Skip to content

Latest commit

 

History

History
97 lines (70 loc) · 6.86 KB

README.md

File metadata and controls

97 lines (70 loc) · 6.86 KB

Jpg

Jpg используется для сокрытия архивов в jpeg/jpg изображениях с возможностью их последующего извлечения. Если вам понравится данная программа, поставьте 🌟 этому репозиторию!

Установка

Предварительные условия

Для того чтобы Jpg работал корректно, требуется лишь наличие ЯП Python в системе. В большинстве дистрибутивов Linux он установлен по умолчанию. Однако если вы наткнулись на исключение, установить Python можно с официальных репозиториев вашего дистрибутива.

Теперь вы готовы к следующему этапу!

Установка Jpg

Для установки рассматриваемой программы выполните команду ниже:

git clone --depth 1 https://github.com/Krator3/Jpg ~/.jpg/ && rm -rf ~/.jpg/.git

P.S: Для корректной работы Jpg не требуются файлы LICENSE и README.md, поэтому можете удалить их, если они вам не нужны.

На данный момент программа работает только внутри обозначенного каталога при запуске файла main.py. Чтобы запускать Jpg в любом каталоге, создайте символьную ссылку на основной файл программы в /usr/bin/ и сделайте ее исполняемой:

sudo ln -s ~/.jpg/src/main.py /usr/bin/jpg
chmod +x /usr/bin/jpg

P.S: Если вы желаете использовать su - вместо sudo, не забудьте заменить ~ на путь к вашему пользователю!

Работа с Jpg

На данный момент программа предназначена исключительно для Linux!

Посмотреть функционал Jpg можно при помощи команды jpg -h/--help:

usage: jpg [-h] [-c] [-v] [hide ...] [search ...]

Программа для скрытия различных архивов в jpeg/jpg изображении

positional arguments:
  hide           Спрятать архив в картинку формата .jpg/.jpeg
  search         Искать архив в картинке формата .jpg/.jpeg

options:
  -h, --help     show this help message and exit
  -c, --clear    Очистить исходный файл от секрета
  -v, --version  Отобразить версию программы

Функция hide принимает 2 параметра:

  1. Путь до изображения
  2. Путь до архива, который будет спрятан.

P.S: Их следует указывать после рассматриваемой функции и именно в таком порядке.


Функция search принимает 1 обязательный (путь до изображения сразу после функции) и 1 опциональный параметр (-c/--clear), который можно указать в любом месте команды.

Несмотря на то что команда hide принимает множество типов архивов и форматов файлов, это не значит, что все они будут корректно работать. На данный момент Jpg поддерживает только .zip, .tar.gz и .7z архивы!

P.S: Архивы формата .7z работают, но с небольшим нюансом: при выполнении команды появится ошибка, а архив будет создан с расширением .zip.

К сожалению, опция -c/--clear тоже имеет свою особенность: при использовании параметра у изображения, скорее всего, пропадет превью. Также в теории при передаче большого файла может потребоваться некоторое время на обработку операции.

P.S: При использовании этой опции файл с большой вероятностью будет испорчен! Вполне возможно, что само изображение продолжит функционировать, но записать в него новый "секрет" вряд-ли получится.


Ну и само собой данный софт имеет общепринятые опции: -h/--help и -v/--version.

Файл конфигурации

Данная программа имеет несколько параметров, позволяющих так или иначе изменять поведение программы. Все они находятся в ~/.jpg/src/config.py

Доступные параметры:

language позволяет выбрать язык для программы. Посмотреть на доступные языки и их обозначения можно в файле ~/.jpg/src/detect.py

Удаление Jpg

Для того чтобы полностью удалить Jpg из вашей системы, выполните следующую команду в терминале:

sudo rm -rf ~/.jpg/ /usr/bin/jpg

P.S: Если вы желаете использовать su - вместо sudo, не забудьте заменить ~ на путь к вашему пользователю!

Содействие

Любая помощь со стороны категорически приветствуется! Если вы хотите сообщить о найденных ошибках или предложить нововведение без готового решения, просто откройте новую проблему с соответствующей темой. Если же вы хотите внести свои изменения в проект (например, исправить ошибку, улучшить документацию и так далее), не стесняйтесь и смело создавайте свои PR! В независимости от того, какую помощь вы решили оказать, важно подробно описать ее!

Лицензия

Этот проект лицензируется по лицензии MIT — подробности см. в файле LICENSE.