Package: github-readme-terminal
✨ Elevate your GitHub Profile ReadMe with Minimalistic Retro Terminal GIFs 🚀💻 GitHub ReadME Terminal 🎞️📘 DescriptionA Python project that empowers you to create visually stunning and unique GIFs for your GitHub Profile ReadME. Unleash your creativity and make your profile stand out from the rest!📸 Showcase🗝️ Key Features👾Retro Vibes– Easily simulate a retro PC booting up into a *nix terminal and then running neofetch to display various details about your GitHub activity.🖼️Unleash Your Creativity- Craft unique and eye-catching visuals with complete control. Your GitHub profile is your canvas, and github-readme-terminal is your paintbrush!📈Live GitHub Stats- Keep your profile readme up to date with your latest achievements and contributions with built-in helper functions.🎨Choice of Color Schemes– 10+ popular color schemes to choose from and full support for ANSI color escape sequences.🛠️TOML-based configuration- Provides an easy and organized way to customize your terminal simulation.🎯 Motivation🌈Customizationis at the heart of the project – no more settling for pre-defined templates. Tailor your GitHub Profile ReadME to reflect your personality.🌐 Unlike other GitHub user statistic generators, this project offers afresh approachto showcasing your profile information.🚨 Stand out in the developer community withvisually appealingGIFs that can potentially make a lasting impression.📦High-level constructsand functions for simulating various terminal operations provide unparalleled control over your ReadME aesthetic.⚙️ PrerequisitesPython >=3.9FFmpegGitHub personal access token(Optional)ImgBB API key(Optional)📦 Installation⚙️ To installgithub-readme-terminal, you needpip:python-mpipinstall--upgradegithub-readme-terminal🪧 UsageHere is a basic demonstration:importgifost=gifos.Terminal(width=320,height=240,xpad=5,ypad=5)t.gen_text(text="Hello World!",row_num=1)t.gen_text(text="With\x1b[32mANSI\x1b[0m escape sequence support!",row_num=2)github_stats=gifos.utils.fetch_github_stats(user_name="x0rzavi")# needs GITHUB_TOKEN in .env or as environment variablet.delete_row(row_num=1)t.gen_text(text=f"GitHub Name:{github_stats.account_name}",row_num=1,contin=True)t.gen_gif()image=gifos.utils.upload_imgbb(file_name="output.gif",expiration=60)# needs IMGBB_API_KEY in .env or as environment variableprint(image.url)For advanced usage, please referhere🛠️ ConfigurationTunable options can be set in two locations:Inside TOML files located in~/.config/gifos/.As environment variables.📑 TOML configuration file format# gifos.toml[general]debug=falsecursor="_"show_cursor=trueblink_cursor=falseuser_name="x0rzavi"# for promptfps=15color_scheme="rose-pine"[files]frame_base_name="frame_"frame_folder_name="frames"output_gif_name="output"# ansi_escape_colors.toml[yoru][yoru.default_colors]fg="#edeff0"bg="#0c0e0f"[yoru.normal_colors]black="#232526"red="#df5b61"green="#78b892"yellow="#de8f78"blue="#6791c9"magenta="#bc83e3"cyan="#67afc1"white="#e4e6e7"[yoru.bright_colors]black="#2c2e2f"red="#e8646a"green="#81c19b"yellow="#e79881"blue="#709ad2"magenta="#c58cec"cyan="#70b8ca"white="#f2f4f5"📑 Environment variables formatexportGIFOS_GENERAL_DEBUG=trueexportGIFOS_GENERAL_COLOR_SCHEME="catppuccin-mocha"exportGIFOS_CATPPUCCIN-MOCHA_DEFAULT_COLORS_FG="white"exportGIFOS_CATPPUCCIN-MOCHA_DEFAULT_COLORS_BG="black"# Other variables are named similarly📂 Optional API keysOptional API keys for modules must be present in.envfile or declared as environment variables:GITHUB_TOKENRepository access - All repositoriesRepository permissions - Contents: Read-onlyIMGBB_API_KEY🌈 Color schemes includedyoru- Defaultgruvbox-darkgruvbox-lightrose-pinedraculanordcatppuccin-mochacatppuccin-latteonedarkmonokai📃 RoadmapAdd proper documentation.Add GitHub streak statistics.Properly handle exceptions.Add unit tests.Support for more ANSI escape codes.More in-built color schemes.More in-built text animations.🌱 ContributingThis is an open source project licensed under MIT and we welcome contributions from the community. We appreciate all types of contributions, including bug reports, feature requests, documentation improvements, and code contributions.🤝 Acknowledgmentsliamg/liamg- Inspiration.anuraghazra/github-readme-stats- GitHub Stats calculation logic.hchargois/gohufont- Built-in font file.Creators of all the color schemes included in this project.✨ Craft your masterpiece with github-readme-terminal and showcase your unique GitHub profilehere✨