關於項目

針對性攻擊單字清單建立器：引入與目標相關的個人訊息，組合每個單字並將結果轉換為可能的密碼。 lyricpass模組允許搜尋與藝術家相關的歌詞並將其包含到單字清單中。
可自訂的大小寫和leet 轉換：透過簡單的設定檔建立自訂字元集和轉換模式。
支援交互模式和一行命令介面。
自 2019 年 8 月起包含在BlackArch Linux滲透測試發行版和Rawsec 的網路安全清單中。

內建

Python 3 （二級分支保留 Python 2.7 舊版支援）
- 要求
- 活著的進步

什麼是新的

2.4.7 發布(02/09/2024)：速度和效能顯著提高。新的擴充大小寫轉換模式允許產生所有可能的大小寫轉換。

（回到頂部）

入門

安裝

 pip install bopscrk

或者，如果您想從 Github 克隆儲存庫而不是從 Pypi 安裝它：

 git clone --recurse-submodules https://github.com/r3nt0n/bopscrk
cd bopscrk
pip install -r requirements.txt

運行互動模式

 bopscrk -i

（回到頂部）

用法


  -h, --help         show this help message and exit
  -i, --interactive  interactive mode, the script will ask you about target
  -w                 words to combine comma-separated (non-interactive mode)
  --min              min length for the words to generate (default: 4)
  --max              max length for the words to generate (default: 32)
  -c, --case         enable case transformations
  -l, --leet         enable leet transformations
  -n                 max amount of words to combine each time (default: 2)
  -a , --artists     artists to search song lyrics (comma-separated)
  -o , --output      output file to save the wordlist (default: tmp.txt)
  -C , --config      specify config file to use (default: ./bopscrk.cfg)
  --version          print version and exit

欲了解更多信息，請參閱高級使用部分。

（回到頂部）

它是如何運作的

您必須提供一些單字作為基礎。
歌詞通行證功能允許介紹藝術家。該工具將下載他所有歌曲的歌詞，每行都將添加為一個新單字。預設情況下，還將添加藝術家姓名和每個短語上單字首字母組成的單字。
該工具將產生它們之間所有可能的組合。
為了產生更多組合，它會添加一些常見的分隔符號（例如“-”、“_”、“.”）、數字和密碼中常用的特殊字元。
您可以使用leet和case 轉換來增加機會。

尖端

欄位可以留空。
您可以在單字和特殊字符中使用重音符號（如果您使用非互動模式，請使用反斜線轉義特殊字符，例如'和" ，例如： bopscrk -w John,O'hara,Doe,foo,bar ）。
在其他欄位中，您可以編寫多個單字，以逗號分隔。例：2C、Flipper。
如果要產生所有可能的 leet 轉換，請在設定檔中啟用recursive_leet 選項。
如果要產生所有可能的大小寫轉換，請在設定檔中啟用extrassed_case選項。
您可以選擇透過cfg 檔案找到的歌詞短語套用哪些轉換。
使用非互動模式，您應該以長短方式提供年份（1970,70）以獲得與互動模式相同的結果。
你必須小心-n參數。如果設定很大的值，可能會導致單字清單太大。我建議使用 2 到 5 之間的值。
要透過命令列提供多個藝術家姓名，您應該提供以逗號分隔的名稱。例： -a johndoe,johnsmith
要透過命令行為藝術家名稱提供空格，您應該將其用引號括起來。例： -a "john doe,john smith"

（回到頂部）

進階用法

使用 .cfg 檔案自訂行為

在bopscrk.cfg檔案中，您可以指定自己的字元集並啟用/停用選項：
- extra_combinations （如(john, doe) => 123john, john123, 123doe, doe123, john123doe doe123john ）預設啟用。您可以在設定檔中停用它，以獲得更有針對性的單字清單。
- seperators_chars ：在額外組合中使用的字元。可以是單一字元或字串，例如： !?-/&(
- seperators_strings ：在額外組合中使用的字串。可以是單一字串或空格分隔的字串列表，例如： 123 34!@
- leet_charset : leet 變換中要替換的字元和對應的替換，例如： e:3 b:8 t:7 a:4
- recursive_leet ：啟用 leet_transforms() 函數的遞歸呼叫以取得所有可能的 leet 變換。警告：使用巨大的--max值（例如：大於 18）啟用可能需要很長時間。可以是真的也可以是假的。
- extra_case ：預設情況下，bopscrk 僅套用更常見的大小寫轉換：所有字元轉換為小寫，所有字元轉換為大寫，每個字元轉換為大寫，所有對轉換為大寫，所有賠率轉換為大寫，所有子音轉換為大寫，所有元音轉換為大寫。您可以啟用此選項來獲取所有可能的大小寫轉換，這可能會導致更大的單字列表，但在某些情況下可能很有用。可以是真的也可以是假的。
- remove_parenthesis ：刪除任何轉換之前找到的歌詞中的所有括號
- take_initials ：根據找到的歌詞短語中每個單字的首字母產生單字（如果啟用並停用remove_parenthesis，則可能會產生無用的單字）
- Artist_split_by_word ：拆分藝術家姓名並將每個單字新增為新單字
- lyric_split_by_word ：與找到的歌詞相同
- Artist_space_replacement ：以字元集中定義的字元/字串取代藝術家姓名中的空格
- lyric_space_replacement ：與找到的歌詞相同
- space_replacement_chars ：在藝術家姓名或歌詞短語中插入代替空格的字元。可以是單一字元或字串，例如： !?-/&(
- space_replacement_strings ：要插入的字串，而不是藝術家姓名或歌詞短語中的空格。可以是單一字串或空格分隔的字串列表，例如： 123 34!@
參數配置舉例
- 使用點作為分隔符號組合所有單詞，並使用逗號作為分隔符
  separators_chars=.,
- 將所有出現的“a/A”轉換為“4”，將所有出現的“e/E”轉換為“3”
  leet_charset=a:4 e:3

（回到頂部）

抒情通行證

此功能基於最初由 initstring 開發的工具的修改版本。這些變更是為了將輸入和輸出工具與 bopscrk 整合。

它將檢索屬於您提供的藝術家的所有歌曲的所有歌詞。預設情況下，它將儲存每個藝術家、透過空格替換找到的每個短語、找到的每個短語縮減為其首字母（如果您啟動了 leet 和 case 轉換，則稍後將對其進行轉換）。

（回到頂部）

路線圖

改善記憶體管理
- 在執行期間將單字清單寫入檔案系統並將其用作快取（#12）
提升績效
- 改進平行邏輯
額外功能
- 實現進度條，讓使用者了解執行狀態
- 實作會話檔案來追蹤執行點並能夠停止和復原會話(#12)
- 為自訂大小寫轉換建立組態選項（例如：停用對/奇數轉換）
- 實現“pipable”輸出以允許與其他工具整合（ -q標誌將僅將最終單字清單輸出到標準輸出）

請參閱未決問題以取得建議功能（和已知問題）的完整清單。

（回到頂部）

貢獻

貢獻使開源社群成為學習、啟發和創造的絕佳場所。我們非常感謝您所做的任何貢獻。

如果您有更好的建議，請分叉該儲存庫並建立拉取請求。您也可以簡單地使用標籤“增強”來開啟問題。不要忘記給該項目一顆星！再次感謝！

分叉項目
建立您的功能分支（ git checkout -b feature/AmazingFeature ）
提交您的更改（ git commit -m 'Add some AmazingFeature' ）
推到分支（ git push origin feature/AmazingFeature ）
打開拉取請求

貢獻者

noraj 貢獻了幾個問題和拉取請求，可以修復一些重要的錯誤。他還自行管理了 BlackArch 和 RawSec 儲存庫中的工具添加，這提高了其受歡迎程度和使用量
nylocx 和 agoertz-fls 貢獻了添加 Python3 支持
glozanoa 和 fabaff 貢獻了添加 bopscrk 命令（setup.py 的改進）

謝謝大家！

（回到頂部）

變更清單

2.4.7 version notes (02/09/2024)
- 改進大小寫轉換邏輯（現在它尊重原始單字的大小寫）
- 包括新的基本案例轉換操作
- 實作擴充案例轉換模式
- 修復拼字錯誤
2.4.6 version notes (30/08/2024)
- 提高並行效能（真正的多處理實作）
- 更好地處理配置解析器錯誤
- 修復拼字錯誤
2.4.5 version notes (02/08/2022)
- 進度條已實施並正在運行
- 包含version參數
- 文件得到改進
2.4.4 version notes (31/07/2022)
- 相對導入錯誤已修復
- 開始重構總體結構以允許包含進度條功能
2.4.3 version notes (28/07/2022)
- 修復項目結構以允許透過 pip 正確安裝：
  - 新增 MANIFEST 以在建置 dist 時排除已編譯和測試文件
  - 改進結構以正確地將所有結構複製到父目錄內的 python 套件目錄中
  - 修復設定檔的相對路徑
- 提供錯誤的設定檔時捕獲異常（通知並退出）
2.4 version notes (26/07/2022)
- 啟用pip install方法讓安裝過程更容易
- 開始實現更好的記憶體管理（快取字表寫入和讀取 I/O 檔案），但尚未工作
- 更新並修復與依賴項相關的小錯誤
- 刪除的功能：“從其他單字清單中排除”，似乎沒有用，還有其他工具可以完成這項特定工作
2.3.1 version notes
- 修復 Windows 系統上執行時的命名空間錯誤（與 aux.py 模組相關，重新命名為 auxiliars.py）
- 實現了單元測試（以及變換、排除器和組合器函數的簡單單元測試）。
2.3 version notes (15/10/2020)
- 使用 cfg 檔案對藝術家和歌詞進行可自訂的配置轉換
- setup.py 的要求已更新
- 多執行緒邏輯改進
- Leet和案件順序顛倒以提高營運效率
- 修正了歌詞空間替換中的錯誤
- 刪除重複項時修復了錯誤（類型錯誤：不可散列類型：'list' ）
- 記憶體管理和效率得到改善
- 分成模組以改進專案結構
- 修正了單字清單排除功能中的錯誤
2.2 version notes (11/10/2020
- 設定檔已實現
- 新功能：允許建立自訂字元集並透過設定檔轉換模式
- 新功能：實現了遞歸 leet 變換（預設為停用，可以在 cfg 檔案中啟用）
2.2~beta version notes (10/10/2020)
- lyricpass整合已更新為可與 initstring 發布的最新版本一起運行
- --lyrics-all選項已刪除（功能整合在其他選項中）
2.1 version notes (11/07/2020)
- 修復最小和最大長度錯誤
2.0/1.5 version notes (17/06/2020)
- 現在支援 PYTHON 3 ：主分支移至 Python 3。
0-1.2(beta) version notes
- EXCLUDE WORDLISTS ：使用多執行緒排除提高速度
- 新功能：與藝術家相關的歌詞搜尋增加了單字清單的機會