{"id":31806781,"url":"https://github.com/daemon2087/ascii_art","last_synced_at":"2026-04-12T15:12:51.784Z","repository":{"id":303838462,"uuid":"1010165983","full_name":"daemon2087/ascii_art","owner":"daemon2087","description":"ASCII Art Studio for macOS\\Linux","archived":false,"fork":false,"pushed_at":"2025-07-27T18:33:35.000Z","size":1090,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-08T16:28:13.558Z","etag":null,"topics":["ascii-art","c","cmake","cpp","imgui","linux","linux-app","macos","macos-app","swift","swiftui"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daemon2087.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-28T13:45:55.000Z","updated_at":"2025-07-27T18:33:39.000Z","dependencies_parsed_at":"2025-07-10T01:27:03.402Z","dependency_job_id":"07e48d86-ab78-430c-bb52-a514f0d0a45b","html_url":"https://github.com/daemon2087/ascii_art","commit_stats":null,"previous_names":["dmitry2087/ascii_art","daemon2087/ascii_art"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/daemon2087/ascii_art","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daemon2087%2Fascii_art","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daemon2087%2Fascii_art/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daemon2087%2Fascii_art/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daemon2087%2Fascii_art/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daemon2087","download_url":"https://codeload.github.com/daemon2087/ascii_art/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daemon2087%2Fascii_art/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006108,"owners_count":26084026,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ascii-art","c","cmake","cpp","imgui","linux","linux-app","macos","macos-app","swift","swiftui"],"created_at":"2025-10-11T03:50:12.845Z","updated_at":"2025-10-11T03:50:14.148Z","avatar_url":"https://github.com/daemon2087.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ASCII ART STUDIO\nДесктопное приложение ASCII Art Studio под операционные системы macOS и Linux. Позволяет работать с переводом изображений и печатью слов в ASCII.\n\n## Функционал\n- **Перевод изображений в ASCII символы**: На вход пользователь загружает растровое изображение формата *.png, *.jpg и т.д. Программа конвертирует загруженное изображение в ASCII-арт (набор ASCII-символов, которые в совокупности визуально представляют собой исходное изображение), и выводит его на экран.\n- **Печать слов в ASCII коде**: Например, пользователь ввел \"Hello, world!\". Приложению требуется обработать буквы всего текста и вывести их в нужном виде.\n\nЕсли в приложении не происходит никаких действий, выводится набор динамично меняющихся ASCII-символов, в совокупности представляющие собой анимированное изображение.\n\n## Технологии и требования\n### macOS:\n- Apple Silicon (M1+)\n- macOS 14.0+  \n- Swift (5.9+)  \n- Clang 15+\n- Xcode 15+\n- Homebrew\n\n### Linux:\n- Ubuntu Linux 22.04+ \n- ImGui 1.92.1+\n- GCC\\G++ 12.0+\n- OpenGL\\GLFW 3.3+\n\n### Общие требования:\n- C++20\n- CMake 3.20+\n- Visual Studio Code\n\n### Зависимости\n- **JSON**: [json.hpp](https://github.com/nlohmann/json)  \n- **IMGUI**: [ImGui_files](https://github.com/ocornut/imgui)  \n- **STB**: [stb_image.h](https://github.com/nothings/stb)  \n\n## Установка и запуск\n### macOS:\nТак как macOS и Linux UNIX-системы, у них есть множество схожих моментов, но есть и различия. На macOS, в основном, уже практически все предустановлено, в отличие от Linux и работать с ней в этом плане легче. Давайте приступим к установке приложения:\n\n1. **Cистема**. Если Вы вдруг не знаете, какая версия macOS у Вас установлена, то выполните команду ниже в приложении Terminal. У Вас должна быть версия не ниже 14.0.\n\n```zsh\nsw_vers -productVersion\n```\n\n2. **Xcode и Command Line Tools**. Git на macOS будет предустановлен после установки Xcode, поэтому его пропустим. Установим Xcode и Command Line Tools, для этого установите в [Mac App Store](https://apps.apple.com/app/xcode) Xcode. После установки выполните в Terminal команду ниже, начнется установка Command Line Tools, а если уже установлена, то выведет соответствующие сообщение. \n\n```zsh\nxcode-select --install\n```\n\n3. **Clang**. Проверим версию Clang, которая у нас была установлена с Command Line Tools, выполните команду ниже, версия должна быть 15.0.0 или выше.\n\n```zsh\nclang --version\n```\n\n4. **Swift**. Выполните в Terminal команду ниже, должна быть 5.9 или выше. Он автоматически устанавливается с Xcode.\n\n```zsh\nswift --version\n```\n\n5. **Homebrew**. Если у Вас не установлен Homebrew, то выполните команду ниже в Terminal, она установит его. \n\n```zsh\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\n```\n\n6. **CMake**. После установки Homebrew выполните команду ниже. Это установит CMake и им можно будет пользоваться.\n\n```zsh\nbrew install cmake\n```\n\nПроверить его версию можно с помощью команды ниже. Его версия должна быть 3.20 или выше. \n\n```zsh\ncmake --version\n```\n\n7. **Visual Studio Code**. Для работы нужна будет VS Code. Установите ее через команду Homebrew ниже.\n\n```zsh\nbrew install --cask visual-studio-code\n```\n\nПосле установки VS Code нам нужно скачать расширения, а именно: CMake Tools, Swift, С\\С++.\n\n8. **Репозиторий**. После того, как мы все установили для работы приложения, то можно приступать к запуску. Выберите удобную папку для проекта. Теперь в нее нужно будет спуститься в Terminal, для этого выполните команду ниже. \n\n```zsh\ncd путь_к_вашей_папке\n```\n\nТеперь мы можем клонировать наш репозиторий, а именно выполнить команду ниже в Terminal. Теперь репозиторий склонирован в нашу папку.\n\n```zsh\ngit clone https://github.com/dmitry2087/ascii_art.git\n```\n\n9. **Сборка и запуск**. Откройте папку с проектом в VS Code. CMake Tools должен автоматически определить проект и предложить его сконфигурировать. Нужно выбрать версию компилятора Clang не ниже 15.0.0. После этого CMake создат Unix файлы, они на мне нужны, поэтому в Terminal переходим к папке нашего проекта. Там удаляем папку build командой.\n\n```zsh\nrm -rf build\n```\n\nПотом создаем новую папку build. \n\n```zsh\nmkdir build\n```\n\nЗатем, туда спускаемся.\n\n```zsh\ncd build\n```\n\nИ выполняем в Terminal команды, сначала первую.\n\n```zsh\ncmake .. -G Xcode\n```\n\nА затем собираем проект.\n\n```zsh\ncmake --build .\n```\n\nПосле этого весь проект будет скомпилирован и успешно собран. В папке build, в подпапке Debug будет храниться наш ```AsciiArtStudio.app```, его можно запустить и пользоваться приложением.\n\n### Ubuntu Linux:\n1. **Система**. Убедитесь, что у вас установлена Ubuntu Linux версии 22.04 или новее. Для этого выполните команду ниже.\n\n```bash\nlsb_release -a\n```\n\nДля начала установки рекомендуется обновить все пакеты системы, выполните команду. \n\n```bash\nsudo apt update\n```\n\n2. **Git**. Установить Git можно командой ниже.\n\n```bash\nsudo apt install git\n```\n\n3. **GCC/G++**. Установить компиляторы GCC и G++ можно командой ниже.\n\n```bash\nsudo apt install build-essential\n```\n\nПосле установки проверьте их версии, должны быть не ниже 12.0.\n\n4. **CMake**. Установить его можно командой ниже.\n\n```bash\nsudo apt install cmake\n```\n\nПроверьте версию CMake. Требуется версия 3.20 или выше.\n\n5. **OpenGL/GLFW**. Для графической части приложения необходимы OpenGL и GLFW. Установите их командой.\n\n```bash\nsudo apt install libglfw3-dev libgl1-mesa-dev libdecor-0-0 libdecor-0-dev\n```\n\nДолжны быть установлены версии не ниже 3.3.\n\n6. **Visual Studio Code**. Для установки VS Code с помощью менеджера пакетов потребуется несколько шагов. Сначала нужно добавить ключ Microsoft и репозиторий. Обратите внимание, что если у вас архитектура процессора не x86, а ARM, то нужно заменить ```[arch=amd64]``` на ```[arch=arm64]```. \n\n```bash\nwget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor \u003e packages.microsoft.gpg\nsudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/\nsudo sh -c 'echo \"deb [arch=amd64] https://packages.microsoft.com/repos/code stable main\" \u003e /etc/apt/sources.list.d/vscode.list'\n```\n\nЗатем можно будет командой установить VS Code.\n\n```bash\nsudo apt install code\n```\n\n7. **Репозиторий**. Выберите удобную папку для проекта и перейдите в нее в терминале.\n\n```bash\ncd путь_к_вашей_папке\n```\n\nЗатем клонируйте репозиторий. \n\n```bash\ngit clone https://github.com/dmitry2087/ascii_art.git\n```\n\n8. **Сборка и запуск**. Откройте папку с проектом в VS Code. CMake Tools должен автоматически определить проект и предложить его сконфигурировать. Нам нужно выбрать версию компилятора GCC или G++ 14.2 или выше. После этого CMake создаст Unix файлы, они на мне нужны, поэтому в Terminal переходим к папке нашего проекта. Там вводим команду для удаления папки build.\n\n```bash\nrm -rf build\n```\n\nПотом создаем новую папку build.\n\n```bash\nmkdir build\n```\n\nЗатем спускаемся в папку.\n\n```bash\ncd build\n```\n\nИ выполняем в Terminal команды.\n\n```bash\ncmake ..\n```\n\nА затем собираем проект.\n\n```bash\ncmake --build .\n```\n\nПосле этого проект будет скомпилирован и успешно собран. В папке build будет храниться наш ```AsciiArtStudio```, его можно запустить командой терминала ниже и пользоваться приложением.\n\n```bash\n./AsciiArtStudio\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaemon2087%2Fascii_art","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaemon2087%2Fascii_art","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaemon2087%2Fascii_art/lists"}