Added readme

README.md

@@ -1 +1,85 @@
-# scripts
+# Scripts Repository
+
+A collection of utility scripts for file management, media processing, automation, Outlook handling, and more. The repository is organized by topic, with helpers for working with CSV/XLSX data, downloads, file renaming, and platform-specific tasks.
+
+## Repository Structure
+
+- `file-management/` - Scripts to process CSV and Excel files, clean contact lists, merge worksheets, and manage data exports.
+- `linkedin/` - LinkedIn export and post automation helpers.
+- `media/` - Downloaders, converters, and media extraction utilities for video, audio, and archives.
+- `odilo/` - Scripts for working with Odilo ebook and EPUB content.
+- `outlook/` - Outlook login, token retrieval, and import automation scripts.
+- `pdfs/` - PDF splitting utilities.
+- `replace_remove/` - File name cleanup and batch renaming scripts.
+- `wordpress/` - WordPress export/article helpers.
+
+## Key Script Categories
+
+### file-management
+- `buscar_grandes.sh` - Find large files.
+- `filtrar_excel_per_csv.py` - Filter Excel data using a CSV file.
+- `juntar_csv.py` - Join or concatenate CSV files.
+- `mautic.py`, `mautic_tags.py`, `nan-mautic.py` - Mautic contact/tag management helpers.
+- `netejar_desuscrits.py` - Clean unsubscribed contacts.
+- `netejar_excel.py` - Clean Excel content.
+- `split_excel.py` - Split Excel files into smaller files or sheets.
+- `teams.py` - Teams-related export or processing script.
+- `treure_etiquetes_mautic.py` - Remove Mautic tags.
+- `unificar_excels.py`, `unir_excels_pestanyes.py` - Merge Excel files and worksheets.
+
+### linkedin
+- `linkedin-posts.py` - LinkedIn post automation or export script.
+
+### media
+- `audio-extractor.sh` - Extract audio from video.
+- `convert_mp4_to_webm.sh` - Convert MP4 files to WEBM.
+- `download_instagram_images.sh`, `instagram-downloader.sh`, `image-instagram-downloader.sh` - Instagram download utilities.
+- `video-downloader.sh` - Download videos from URLs.
+- `url-video-downloader.sh` - Download videos given URL lists.
+- `webm-to-mp4-converter.sh` - Convert WEBM files to MP4.
+- `zip_cbr_files.sh` - Compress files into CBR archives.
+- `copy_cbr_files.sh` - Copy or manage CBR files.
+- `export_instagram_cookies.py` - Export cookies for Instagram automation.
+- `spotify-rss.py` - Generate RSS content for Spotify.
+
+### replace_remove
+- `fix-all-special-characters.sh` - Normalize special characters in names.
+- `remove_parentheses_files_folders.sh` - Remove parentheses from file and folder names.
+- `remove_parentheses_folders.sh` - Remove parentheses from folder names.
+- `replace_hyphen_with_underscores.sh` - Replace hyphens with underscores.
+- `replace_spaces_with_underscores.sh` - Replace spaces with underscores.
+- `replace_triple_with_underscores.sh` - Replace triple underscores patterns.
+- `replace_under_hyphen_under_with_underscores.sh` - Normalize mixed underscore/hyphen patterns.
+
+### outlook
+- `email_login.py` - Outlook email login helper.
+- `get_token.py` - Retrieve Outlook authentication tokens.
+- `marti.py`, `marti_import.csv`, `guillem_import.csv` - Import helpers for Outlook contact data.
+
+### odilo
+- `biblio_odilo.py` - Odilo ebook processing script.
+- `recollir_epubs.sh` - Collect EPUB files.
+
+### pdfs
+- `split_pdf_pages.sh` - Split PDF files by page.
+
+### wordpress
+- `export-articles.py` - Export WordPress articles.
+- `agile611_posts.csv` - Example or export data.
+
+## Usage
+
+Most scripts are standalone and can be run directly from the terminal. Use `python` for `.py` scripts and `bash` or `sh` for `.sh` scripts.
+
+Example:
+
+```bash
+python file-management/juntar_csv.py
+bash media/video-downloader.sh
+```
+
+> Note: Some scripts may require additional dependencies or environment setup. Check the script header or comments for usage details.
+
+## Contribution
+
+Feel free to add new utilities, improve documentation, or organize the repository further by task area.