منصوبے کے بارے میں

animfetch ایک ٹرمینل یوٹیلیٹی ہے جو ایک متحرک سسٹم فیچ (سسٹم معلومات کے ساتھ ASCII آرٹ) ٹرمینل کے اوپری حصے میں پن کر کے دکھاتی ہے جبکہ صارف کا اپنا شیل نیچے کام کرتا رہتا ہے۔ یہ Linux اور macOS کے لیے ہے اور Rust میں لکھی گئی ہے۔ بنیادی رویہ: - `--pin` ایک اسکرول ریجن سیٹ کرتا ہے تاکہ اوپری قطاریں مقرر رہیں، پھر انہیں الگ کر کے دوبارہ پینٹ کرتا ہے جبکہ صارف کا شیل نیچے ہسٹری، کمپلیشن اور ایلیسز کے ساتھ برقرار رہتا ہے۔ `--unpin` اسے واپس کرتا ہے۔ - `--play` چند سیکنڈ کے لیے اپنی جگہ اینیمیشن چلاتا ہے اور ختم ہو جاتا ہے۔ - `--once` ایک واحد جامد فریم پرنٹ کرتا ہے۔ - بغیر کسی فلیگ کے چلانے پر ایک انٹرایکٹو موڈ شروع ہوتا ہے جس میں animfetch پرامپٹ کا مالک ہوتا ہے۔ اینیمیشنز اور رینڈرنگ: - بلٹ اِن اینیمیشنز کی بڑی لائبریری، غیر رنگین اور رنگین دونوں، جن میں جانور، اشیاء اور کردار شامل ہیں (مثلاً cat-run، fox-run، dolphin-swim، blackhole، earth، saturn، dragon، rocket)۔ - ہر رن کے لیے `-a <name>` سے اینیمیشن منتخب کریں یا `--set <name>` سے ڈیفالٹ مقرر کریں۔ - `--style` ڈرائنگ کا طریقہ منتخب کرتا ہے: `half` اور `quad` ٹھوس بلاکس رینڈر کرتے ہیں اور کسی بھی ٹرمینل پر ری اسکیل کرتے ہیں؛ `ramp` کوریج کو حروف پر میپ کرتا ہے؛ `raw` آرٹ کے اپنے حروف کو بغیر تبدیلی پرنٹ کرتا ہے، جو ہاتھ سے بنے یا پہلے سے رنگین ASCII کے لیے موزوں ہے۔ - اختیارات میں `--width`، `--height`، `--fps`، `--no-color`، اور `--art-color own|theme` شامل ہیں۔ - آؤٹ پٹ پائپ کرنے یا `NO_COLOR=1` سیٹ کرنے پر خودکار طور پر جامد راستے پر واپس آ جاتا ہے۔ تنصیب: - Arch Linux میں `paru -S animfetch-bin` یا `animfetch-git` کے ذریعے۔ - Nix/NixOS میں `nix run github:Andrew-Velox/animfetch` کے ذریعے یا اسے flake input کے طور پر شامل کر کے۔ - کسی بھی Linux یا macOS کے لیے پہلے سے بنی بائنری انسٹال اسکرپٹ، جو `~/.local/bin` یا روٹ کے طور پر `/usr/local/bin` میں انسٹال کرتی ہے، `ANIMFETCH_BINDIR` اوور رائیڈ کے ساتھ۔ - سورس سے Rust 1.88 یا جدید تر کے ساتھ `cargo install --locked --git ...` کے ذریعے۔ کنفیگریشن: - اختیاری `~/.config/animfetch/config.toml`؛ ہر کلید اختیاری ہے اور خراب فائل ڈیفالٹس پر واپس آ جاتی ہے۔ - `color_source = "palette"` سیٹ کرنے سے فیچ ڈیسک ٹاپ تھیم کی پیروی کرتا ہے، matugen، pywal یا wallust پیلیٹ پڑھ کر؛ `--pin` کے تحت یہ تبدیلی پر دوبارہ پڑھتا ہے تاکہ ری تھیمنگ چلتی اینیمیشن کو دوبارہ رنگ دے۔ شیل انٹیگریشن: - bash، zsh اور fish کے لیے مثال اسٹارٹ اپ لائنیں غیر انٹرایکٹو شیلز اور `scp` سے بچاتی ہیں؛ README مشورہ دیتا ہے کہ اسٹارٹ اپ فائلوں میں کبھی ننگا `animfetch` استعمال نہ کریں کیونکہ یہ ان پٹ کا انتظار کرتا ہے۔ انٹرایکٹو موڈ کی کلیدیں: - Enter فیچ کے نیچے آؤٹ پٹ کے ساتھ کمانڈ چلاتا ہے؛ Ctrl-C مداخلت کرتا ہے یا چھوڑ دیتا ہے؛ Esc چھوڑ دیتا ہے؛ Ctrl-D خالی لائن پر چھوڑ دیتا ہے؛ Ctrl-U لائن صاف کرتا ہے؛ Ctrl-W آخری لفظ حذف کرتا ہے۔ `cd` اور `exit` اندرونی طور پر سنبھالے جاتے ہیں، باقی سب `$SHELL -c` کے تحت چلتا ہے۔ اسے پرامپٹ والا لانچر کہا گیا ہے، مکمل شیل نہیں (کوئی ایلیسز، ہسٹری یا کمپلیشن نہیں)۔ کریڈٹس میں نوٹ کیا گیا ہے کہ کچھ اینیمیشنز kyome22 کے RunCat سے Apache License 2.0 کے تحت ASCII میں دوبارہ بنائی گئی ہیں۔