Jpg используется для сокрытия архивов в jpeg/jpg изображениях с возможностью их последующего извлечения. Если вам понравится данная программа, поставьте 🌟 этому репозиторию!
Для того чтобы Jpg работал корректно, требуется лишь наличие ЯП Python в системе. В большинстве дистрибутивов Linux он установлен по умолчанию. Однако если вы наткнулись на исключение, установить Python можно с официальных репозиториев вашего дистрибутива.
Теперь вы готовы к следующему этапу!
Для установки рассматриваемой программы выполните команду ниже:
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
, не забудьте заменить ~
на путь к вашему пользователю!
На данный момент программа предназначена исключительно для 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 параметра:
- Путь до изображения
- Путь до архива, который будет спрятан.
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 из вашей системы, выполните следующую команду в терминале:
sudo rm -rf ~/.jpg/ /usr/bin/jpg
P.S: Если вы желаете использовать su -
вместо sudo
, не забудьте заменить ~
на путь к вашему пользователю!
Любая помощь со стороны категорически приветствуется! Если вы хотите сообщить о найденных ошибках или предложить нововведение без готового решения, просто откройте новую проблему с соответствующей темой. Если же вы хотите внести свои изменения в проект (например, исправить ошибку, улучшить документацию и так далее), не стесняйтесь и смело создавайте свои PR! В независимости от того, какую помощь вы решили оказать, важно подробно описать ее!
Этот проект лицензируется по лицензии MIT — подробности см. в файле LICENSE.